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NAME 

intro - introduction to maintenance commands and application programs 
DESCRIPTION 

This section describes, in alphabetical order, commands that are used 
chiefly for system maintenance and administration purposes. The com- 
mands in this section should be used along with those listed in Section 1 of 
the User’s Reference Manual and Sections 1, 2, 3, 4, and 5 of the 
Programmer’ s Reference Manual. References of the form name(Y), (2), 
(3), (4) and (5) refer to entries in the above manuals. References of the 
form name{\M), name(l) or name( 8) refer to entries in this manual. 


COMMAND SYNTAX 

Unless otherwise noted, commands described in this section accept options 
and other arguments according to the following syntax: 

name [option(s)] [ cmdarg(s )] 
where: 

name The name of an executable file. 


option 


noargletter 

argletter 

optarg 

cmdarg 


- noargletter (s) or, 

- argletter ooptarg 

where <> is optional white space. 

A single letter representing an option without an argument. 

A single letter representing an option requiring an argu- 
ment. 

Argument (character string) satisfying preceding argletter. 

Path name (or other command argument) not beginning 
with - or, - by itself indicating the standard input. 


SEE ALSO 

getopt(l) in the User' s Reference Manual. 
getopt(3C) in the Programmer’ s Reference Manual. 


DIAGNOSTICS 

Upon termination, each command returns two bytes of status, one supplied 
by the system and giving the cause for termination, and (in the case of 
“normal” termination) one supplied by the program (see wait{ 2) and 
exit (2)). The former byte is 0 for normal termination; the latter is cus- 
tomarily 0 for successful execution and non-zero to indicate troubles such 
as erroneous parameters, bad or inaccessible data, or other inability to cope 
with the task at hand. It is called variously “exit code”, “exit status”, or 
“return code”, and is described only where special conventions are 
involved. 


September 1988 


- 1 


Version 3.0 


i 



INTRO(IM) 


Silicon Graphics 


INTRO(IM) 


BUGS 

Regrettably, not all commands adhere to the aforementioned syntax. 

ORIGIN 

AT&T V.3 
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NAME 

accept, reject - allow or prevent LP requests 
SYNOPSIS 

/usr/lib/accept destinations 
/usr/lib/reject [— r[ reason]] destinations 

DESCRIPTION 

accept allows lp( 1) to accept requests for the named destinations. A desti- 
nation can be either a line printer (LP) or a class of printers. Use lpstat( 1) 
to find the status of destinations. 

Reject prevents lp( 1) from accepting requests for the named destinations. 
A destination can be either a printer or a class of printers. Use lpstat( 1) to 
find the status of destinations. The following option is useful with reject. 

-r [reason] Associates a reason with preventing Ip from accepting 
requests. This reason applies to all printers mentioned up to 
the next — r option. Reason is reported by Ip when users direct 
requests to the named destinations and by Ipstat(V). If the — r 
option is not present or the -r option is given without a rea- 
son, then a default reason will be used. 

FILES 

/usr/spool/Ip/* 

SEE ALSO 

lpadmin(lM), lpsched(lM). 

enable(l), lp(l), lpstat(l) in the User’ s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

acctdisk, acctdusg, accton, acctwtmp - overview of accounting and miscel- 
laneous accounting commands 

SYNOPSIS 

/usr/lib/acct/acctdisk 
/usr/lib/acct/acctdusg [-u file] [-p file] 

/usr/lib/acct/accton [file] 

/usr/lib/acct/acctwtmp "reason" 

DESCRIPTION 

Accounting software is structured as a set of tools (consisting of both C pro- 
grams and shell procedures) that can be used to build accounting systems. 
acctsh( 1M) describes the set of shell procedures built on top of the C pro- 
grams. 

Connect time accounting is handled by various programs that write records 
into /etc/utmp, as described in utmp( 4). The programs described in 
acctcon( 1M) convert this file into session and charging records, which are 
then summarized by acctmerg(\M). 

Process accounting is performed by the UNIX system kernel. Upon termi- 
nation of a process, one record per process is written to a file (normally 
lusrladmlpacct). The programs in acctprc (1M) summarize this data for 
charging purposes; acctcms(\M) is used to summarize command usage. 
Current process data may be examined using acctcom( 1). 

Process accounting and connect time accounting (or any accounting records 
in the format described in acct( 4)) can be merged and summarized into total 
accounting records by acctmerg (see tacct format in acct( 4)). prtacct (see 
acctsh(lM)) is used to format any or all accounting records. 

acctdisk reads lines that contain user ID, login name, and number of disk 
blocks and converts them to total accounting records that can be merged 
with other accounting records. 

acctdusg reads its standard input (usually from find / -print) and computes 
disk resource consumption (including indirect blocks) by login. If -u is 
given, records consisting of those filenames for which acctdusg charges no 
one are placed in file (a potential source for finding users trying to avoid 
disk charges). If -p is given, file is the name of the password file. This 
option is not needed if the password file is letclpasswd. (See diskusg( 1M) 
for more details.) 

accton alone turns process accounting off. If file is given, it must be the 
name of an existing file, to which the kernel appends process accounting 
records (see acct(2) and acct(A)). 
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acctwtmp writes a utmp{ 4) record to its standard output. The record con- 
tains the current time and a string of characters that describe the reason . A 
record type of ACCOUNTING is assigned (see utmp( 4)). reason must be a 
string of 11 or fewer characters, numbers, $, or spaces. The accounting 
startup and shutdown scripts lusrlliblacctl startup and lusrlliblacctlshutacct 
use the acctwtmp command to record system startup and shutdown events. 

NOTE 

The file /etc/config/acct controls the automatic startup and periodic report 
generation of the accounting subsystem. If this file contains the flag value 
"on", process accounting will be enabled by /etc/init.d/acct each time the 
system is brought up, and nightly reports will be generated and placed in the 
directory lusr/adm/acct. 

/etc/chkconfig should be used to modify the contents of the /etc/config/acct 
file. 


FILES 


/etc/passwd 

/usr/lib/acct 

/usr/adm/pacct 

/etc/wtmp 

/etc/config/acct 


used for login name to user ID conversions 
holds all accounting commands listed in 
sub-class 1M of this manual 
current process accounting file 
login/logoff history file 

if contains "on", accounting runs automatically 


SEE ALSO 

acctcms(lM), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), 

diskusg(lM), fwtmp(lM), runacct(lM), chkconfig(lM) 

acctcom(l) in the User’s Reference Manual 

acct(2), acct(4), utmp(4) in the Programmer' s Reference Manual 


ORIGIN 

AT&T V.3.1 
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NAME 

acctcms - command summary from per-process accounting records 
SYNOPSIS 

/usr/lib/acct/acctcms [options] files 
DESCRIPTION 

acctcms reads one or more files , normally in the form described in acct{A). 
It adds all records for processes that executed identically-named commands, 
sorts them, and writes them to the standard output, normally using an inter- 
nal summary format. The options are: 

-a Print output in ASCII rather than in the internal summary format. 
The output includes command name, number of times executed, 
total kcore-minutes, total CPU minutes, total real minutes, mean 
size (in K), mean CPU minutes per invocation, "hog factor", char- 
acters transferred, and blocks read and written, as in acctcom( 1). 
Output is normally sorted by total kcore-minutes. 

-c Sort by total CPU time, rather than total kcore-minutes. 

— j Combine all commands invoked only once under "***other". 

-n Sort by number of command invocations. 

-s Any filenames encountered hereafter are already in internal sum- 
mary format. 

-t Process all records as total accounting records. The default inter- 
nal summary format splits each field into prime and non-prime 
time parts. This option combines the prime and non-prime time 
parts into a single field that is the total of both, and provides 
upward compatibility with old (i.e., UNIX System V) style 
acctcms internal summary format records. 

The following options may be used only with the -a option. 

-p Output a prime-time-only command summary. 

-o Output a non-prime (offshift) time only command summary. 

When -p and -o are used together, a combination prime and non-prime 
time report is produced. All the output summaries will be total usage 
except number of times executed, CPU minutes, and real minutes, which 
will be split into prime and non-prime. 

A typical sequence for performing daily command accounting and for 
maintaining a running total is: 

acctcms file ... > today 

cp total previoustotal 

acctcms -s today previoustotal > total 

acctcms -a -s today 
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SEE ALSO 

acct(lM), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), 

fwtmp(lM), runacct(lM) 

acctcom(l) in the U ser’ s Reference Manual 

acct(2), acct(4), utmp(4) in the Programmer’ s Reference Manual 

BUGS 

Unpredictable output results if -t is used on new style internal summary 
format files, or if it is not used with old style internal summary format files. 

ORIGIN 

AT&T V.3.1 
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NAME 

acctconl, acctcon2 - connect- time accounting 
SYNOPSIS 

/usr/lib/acct/acctconl [options] 

/ usr/Iib/acct/acctcon2 
DESCRIPTION 

acctconl converts a sequence of login/logoff records read from its standard 
input to a sequence of records, one per login session. Its input should nor- 
mally be redirected from /etclwtmp. Its output is ASCII, giving device, user 
ID, login name, prime connect time (seconds), non-prime connect time 
(seconds), session starting time (numeric), and starting date and time. The 
options are: 

-p Print input only, showing line name, login name, and time (in both 
numeric and date/time formats). 

-t acctconl maintains a list of lines on which users are logged in. 
When it reaches the end of its input, it emits a session record for 
each line that still appears to be active. It normally assumes that its 
input is a current file, so that it uses the current time as the ending 
time for each session still in progress. The -t flag causes it to use, 
instead, the last time found in its input, thus assuring reasonable and 
repeatable numbers for non-current files. 

-\file file is created to contain a summary of line usage showing line 
name, number of minutes used, percentage of total elapsed time 
used, number of sessions charged, number of logins, and number of 
logoffs. This file helps track line usage, identify bad lines, and find 
software and hardware oddities. Hangup, termination of login(l) 
and termination of the login shell each generate logoff records, so 
that the number of logoffs is often three to four times the number of 
sessions. See infi(lM) and utmp(4). 

-o file file is filled with an overall record for the accounting period, giving 
starting time, ending time, number of reboots, and number of date 
changes. 

acctcon2 expects as input a sequence of login session records and converts 
them into total accounting records (see tacct format in acct{ 4)). 

EXAMPLES 

These commands are typically used as shown below. The file ctmp is 
created only for the use of acctprc(\M) commands: 

acctconl -t -1 lineuse -o reboots <wtmp | sort +ln +2 > ctmp 
acctcon2 <ctmp | acctmerg > ctacct 
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FILES 

/etc/wtmp 
SEE ALSO 

acct(lM), acctcms(lM), acctmerg(lM), acctprc(lM), acctsh(lM), 

fwtmp(lM), init(lM), runacct(lM) 

acctcom(l), login(l) in the U ser s Reference Manual 

acct(2), acct(4), utmp(4) in the Programmer’ s Reference Manual 

BUGS 

The line usage report is confused by date changes. Use wtmpfix (see 
fwtmp{ 1M)) to correct this situation. 

ORIGIN 

AT&T V.3.1 
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NAME 

acctmerg - merge or add total accounting files 
SYNOPSIS 

/usr/lib/acct/acctmerg [options] [file] . . . 

DESCRIPTION 

acctmerg reads its standard input and up to nine additional files, all in the 
tacct format (see acct( 4)) or an ASCII version thereof. It merges these 
inputs by adding records whose keys (normally user ID and name) are 
identical, and expects the inputs to be sorted on those keys. Options are: 

-a Produce output in ASCII version of tacct. 

-i Input files are in ASCII version of tacct. 

-p Print input with no processing. 

-t Produce a single record that totals all input. 

-u Summarize by user ID, rather than user ID and name. 

-v Produce output in verbose ASCII format, with more precise notation 
for floating-point numbers. 

EXAMPLES 

The following sequence is useful for making "repairs" to any file kept in 
this format: 

acctmerg -v <filel > file2 
Edit file2 as desired . . . 

acctmerg — i <file2 > filel 

SEE ALSO 

acct(lM), acctcms(lM), acctcon(lM), acctprc(lM), acctsh(lM), 

fwtmp(lM), runacct(lM) 

acctcom(l) in the User’ s Reference Manual 

acct(2), acct(4), utmp(4) in the Programmer’ s Reference Manual 

ORIGIN 

AT&T V.3.1 
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NAME 

acctprcl, acctprc2 - process accounting 
SYNOPSIS 

/usr/Iib/acct/acctprcl [clmp] 

/usr/lib/acct/acctprc2 

DESCRIPTION 

acctprcl reads input in the form described by acct( 4), adds login names 
corresponding to user IDs, then writes for each process an ASCII line giving 
user ID, login name, prime CPU time (tics), non-prime CPU time (tics), and 
mean memory size (in memory segment units). If clmp is given, it is 
expected to contain a list of login sessions, in the form described in 
acctcon( 1M), sorted by user ID and login name. If this file is not supplied, 
it obtains login names from the password file. The information in ctmp 
helps it distinguish among different login names that share the same user ID. 

acctprc2 reads records in the form written by acctprcl , summarizes them 
by user ID and name, then writes the sorted summaries to the standard out- 
put as total accounting records. 

These commands are typically used as shown below: 

acctprcl ctmp </usr/adm/pacct | acctprc2 >ptacct 

FILES 

/etc/passwd 
SEE ALSO 

acct(lM), acctcms(lM), acctcon(lM), acctmerg(lM), acctsh(lM), 

cron(lM), fwtmp(lM), runacct(lM) 

acctcom(l) in the User’ s Ref erence Manual 

acct(2), acct(4), utmp(4) in the Programmer’ s Reference Manual 

BUGS 

Although it is possible to distinguish among login names that share user IDs 
for commands run normally, it is difficult to do this for those commands run 
from cron( 1M), for example. More precise conversion can be done by fak- 
ing login sessions on the console via the acctwtmp program in acct( 1M). 

CAVEAT 

A memory segment of the mean memory size is a unit of measure for the 
number of bytes in a logical memory segment on a particular processor. 

ORIGIN 

AT&T V.3.1 


-1 


September 1988 


Version 3.0 



ACCTSH(IM) 


Silicon Graphics 


ACCTSH(IM) 


NAME 

chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, prctmp, prdaily, 
prtacct, runacct, shutacct, startup, tumacct - shell procedures for account- 
ing 

SYNOPSIS 

/usr/lib/acct/chargefee login-name number 
/usr/lib/acct/ckpacct [blocks] 

/usr/lib/acct/dodisk [-o] [files ...] 

/usr/Iib/acct/lastlogin 
/usr/lib/acct/monacct number 
/usr/lib/acct/nulladm file 
/usr/lib/acct/prctmp 
/usr/lib/acct/prdaily [-1] [-c] [ mmdd ] 

/usr/Iib/acct/prtacct file [ "heading" ] 

/usr/lib/acct/runacct [mmdd] [mmdd state] 

/usr/lib/acct/shutacct [ "reason" ] 

/ usr/lib/acct/star tup 
/usr/lib/acct/turnacct on | off | switch 

DESCRIPTION 

chargefee can be invoked to charge a number of units to login-name. A 
record is written to lusrladmlfee, to be merged with other accounting 
records during the night. 

ckpacct should be initiated via cron(lM). It periodically checks the size of 
/usr/adm/pacct. If the size exceeds blocks, 1000 by default, tumacct will 
be invoked with argument switch. If the number of free disk blocks in the 
lusr file system falls below 500, ckpacct will automatically turn off the col- 
lection of process accounting records via the off argument to tumacct. 
When at least this number of blocks is restored, the accounting will be 
activated again. This feature is sensitive to the frequency at which ckpacct 
is executed, usually by cron. 

dodisk should be invoked by cron to perform the disk accounting functions. 
By default, it will do disk accounting on the special files in /etc/fstab. If the 
— o flag is used, it will do a slower version of disk accounting by login direc- 
tory. files specifies the one or more filesystem names where disk account- 
ing will be done. If files are used, disk accounting will be done on these 
filesystems only. If the -o flag is used, files should be mount points of 
mounted filesystems. If omitted, they should be the special file names of 
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mountable filesystems. 

lastlogin is invoked by runacct to update /usr/adm/acct/sum/loginlog, 
which shows the last date on which each person logged in. 

monacct should be invoked once each month or each accounting period. 
number indicates which month or period it is. If number is not given, it 
defaults to the current month (01-12). This default is useful if monacct is 
to executed via cron (1M) on the first day of each month, monacct creates 
summary files in /usr/adm/acct/fiscal and restarts summary files in 
/usr/adm/acct/sum . 

nulladm creates file with mode 664 and ensures that owner and group are 
adm. It is called by various accounting shell procedures. 

prctmp can be used to print the session record file (normally 
/usr/adm/acct/nite/ctmp created by acctcon( 1M). 

prdaily is invoked by runacct to format a report of the previous day’s 
accounting data. The report resides in lusrladmlacctlsum/rprt mmdd where 
mmdd is the month and day of the report. The current daily accounting 
reports may be printed by typing prdaily. Previous days’ accounting reports 
can be printed by using the mmdd option and specifying the exact report 
date desired. The -1 flag prints a report of exceptional usage by login id for 
the specifed date. Previous daily reports are cleaned up and therefore inac- 
cessible after each invocation of monacct. The -c flag prints a report of 
exceptional resource usage by command, and may be used on current day’s 
accounting data only. 

prtacct can be used to format and print any total accounting ( tacct ) file. 

runacct performs the accumulation of connect, process, fee, and disk 
accounting on a daily basis. It also creates summaries of command usage. 
For more information, see runacct{\M). 

shutacct is invoked during a system shutdown to turn process accounting 
off and append a "reason" record to letc/wtmp. 

startup can be called to turn the accounting on when the system is brought 
to a multi-user state. 

turnacct is an interface to accton (see acct(lM)) to turn process accounting 
on or off. The switch argument turns accounting off, moves the current 
/usr/adm/pacct to the next free name in /usr/adm/pacctincr (where incr is 
a number starting with 1 and incrementing by one for each additional pacct 
file), then turns accounting back on again. This procedure is called by 
ckpacct and thus can be taken care of by the cron and used to keep pacct to 
a reasonable size, acct starts and stops process accounting via init and shut- 
down accordingly. 
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/usr/adm/fee accumulator for fees 

/usr/adm/pacct current file for per-process accounting 

/usr/adm/pacct* used if pacct gets large and during 

execution of daily accounting procedure 
/etc/wtmp login/logoff summary 

/usr/lib/acct/ptelus.awk contains the limits for exceptional 
usage by login id 

/usr/lib/acct/ptecms.awkcontains the limits for exceptional 
usage by command name 
/usr/adm/acct/nite working directory 

/usr/lib/acct holds all accounting commands listed in 

sub-class 1M of this manual 

/usr/adm/acct/sum summary directory, should be saved 

SEE ALSO 

acct(lM), acctcms(lM), acctcon(lM), acctmerg(lM), acctprc(lM), 

cron(lM), diskusg(lM), fwtmp(lM), runacct(lM) 

acctcom(l) in the User' s Reference Manual 

acct(2), acct(4), utmp(4) in the Programmer" s Reference Manual 

ORIGIN 

AT&T V.3.1 


September 1988 


-3- 


Version 3.0 



ADDCLIENT ( 1M ) 


Silicon Graphics 


ADDCLIENT(IM) 


NAME 

addclient - allow remote printing clients to connect 
SYNOPSIS 

/usr/spool/Ip/etc/util/addclient client 
DESCRIPTION 

This command is used on an IRIS that has a printer attached to it. The com- 
mand registers a remote user’s machine, allowing it to connect to this 
machine in order to submit a printing request using Ip (1) . 
client is the name of the remote machine. This command modifies the 
.rhosts file in the home directory of user Ip and possibly letc/passwd. 

Execute this command once for each client machine that will use the net- 
work to submit printing jobs on this machine. 

FILES 

/etc/passwd 

/usr/spool/lp/.rhosts 

SEE ALSO 

mknetpr(lM), mkcentpr(lM), mkPS(lM). 

AUTHOR 

Glen Williams 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

arp - address resolution display and control 

SYNOPSIS 

arp hostname 

arp -a [ unix ] [ kmem ] 

arp -d hostname 

arp -s hostname ether_addr [ temp ] [ pub ] [ trail ] 
arp -f filename 

DESCRIPTION 

The arp program displays and modifies the Intemet-to-Ethemet address 
translation tables used by the address resolution protocol (arp (IP)). 

With no flags, the program displays the current ARP entry for hostname. 
The host may be specified by name or by number, using Internet dot nota- 
tion. With the -a flag, the program displays all of the current ARP entries 
by reading the table from the file kmem (default /dev/kmem) based on the 
kernel file unix (default /unix). 

With the -d flag, a super-user may delete an entry for the host called host- 
name. 

The -s flag is given to create an ARP entry for the host called hostname 
with the Ethernet address ether_addr. The Ethernet address is given as six 
hex bytes separated by colons. The entry will be permanent unless the 
word temp is given in the command. If the word pub is given, the entry 
will be "published"; i.e., this system will act as an ARP server, responding 
to requests for hostname even though the host address is not its own. The 
word trail indicates that trailer encapsulations may be sent to this host. 

The -f flag causes the file filename to be read and multiple entries to be set 
in the ARP tables. Entries in the file should be of the form 

hostname ether addr [ temp ] [ pub ] [ trail ] 
with argument meanings as given above. 

SEE ALSO 

inet(7P), arp(7P), ifconfig(lM) 

ORIGIN 

4.3BSD 
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NAME 

beer - Backup files Easily, Effectively, and Reliably 
SYNOPSIS 

/usr/adm/beer/beer [ anything ] 

DESCRIPTION 

Introduction 

Beer is a program designed to automate full and incremental backups, using 
bru(l) to do the actual archiving. It takes one optional argument, which is 
used to turn debugging output on. The text of the argument is irrelevant, 
beer only cares whether or not an argument is there. 

Full And Incremental Backups 

Full backups are done quarterly, while incremental backups are done 
monthly, weekly, and daily. Monthly backups are done relative to the last 
quarterly, weekly backups are relative to the last monthly (or quarterly if no 
monthlies), and dailies are relative to the last weekly (or monthly, or quar- 
terly). For example, when doing weekly backups, only files which have 
changed since the last monthly or quarterly backup will be dumped to tape. 

Beer automatically determines which kind of backup to do, and keeps track 
of which tapes to use for any given kind of incremental backup. (It is 
assumed that quarterly backup tapes are not re-used, but kept “per- 
manently” for future reference.) 

Tape Sets 

The usual procedure is to have multiple tape sets for each kind of incremen- 
tal backup. For instance, between each monthly backup, there should be 
three weekly backups. Each of these weeklies will have its own set of tapes. 

Beer automatically manages the tape sets, instructing the operator which 
tape set to use for this particular backup session. 

For security, it is a good idea to keep an additional tape set of the more fre- 
quent types of backups relative to the less frequent. For example, the 
sequence might be as follows: 

QwwwMwwwM 
12 3 14 12 2 

where “Q” is a quarterly, “w” is a weekly, and “M” is a monthly. After 
the first monthly, weekly sets 1 and 2 can be re-used, but weekly set 3 
should be kept until after the second monthly backup has been completed. 

Tape Configuration File 

Beer uses one configuration file which controls which tapes it will use. All 
other options are built into beer itself, and are easily changeable, since beer 
is just a large shell program. 
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The file which beer uses is /usr/adm/beer/tapesets. For each kind of incre- 
mental backup, this file lists how many tape sets there are, and which one to 
use next. The initial file is set up for the tape configuration described 
above, with four monthly tape sets, four weekly tape sets, and two daily 
tape sets. It is updated automatically each time beer is run. It should 
almost never have to be edited by hand. 

In /usr/adm/beer/tapesets, beer will ignore empty lines, and treat any part 
of a line that begins with a # as a comment. The # cannot be escaped. Beer 
will also ignore case distinctions on the information in this file. 

Touch Files 

Beer keeps a set of “touch” files, whose modification time is used for con- 
trolling which files to backup. These files all reside in the 
/usr/adm/beer/touch directory. For example, since weekly backups are 
done relative to the last monthly, beer instructs bru to backup all files newer 
than the file /usr/adm/beer/touch/monthly (or 

/usr/adm/beer/touch/quarterly if no monthlies were done since the last 
quarterly). 

Log Files 

Beer also keeps a set of “log” files, containing the bru output from the par- 
ticular backup. These files reside in /usr/adm/beer/log, and their names are 
indicative of which tape set was used, and the date. The bru output con- 
tains the volume number in square brackets ([ ]), so, between the file name 
itself, and the contents of the file, it should be possible to locate exactly 
which tape any given user’s file is archived on. (A member of the Lab Staff 
should be contacted to actually restore the files, since this requires Root 
access for best results.) 

Beer will automatically delete the “touch” and “log” files that should not 
be kept after any particular backup. For example, after a quarterly dump, it 
will delete the monthly and weekly “touch” files, all the daily and weekly 
“log” files, and all but the last monthly “log” file. 

Quarterly dumps are not logged to disk, but are instead piped through pr( 1) 
(with an appropriate heading), and then to lpr( 1). Since printers tend to 
jam, beer will ask the operator if it really should send the output to the 
printer. If the operator’s answer begins with an “n”, beer will cause bru to 
do its work silently. 

Automatic Backup Type Selection 

Beer automatically decides what kind of incremental backup to do, based 
on the date and day of the week. If it is the day of the week given for 
weekly or monthly backups, and it is within the first day of the month, beer 
will do a monthly backup. Otherwise, it will do a weekly backup. If it is 
not the day of the week for monthly and weekly backups, beer will simply 
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do a daily backup. 

The type of backup that beer chooses is merely a default; the operator may 
over-ride the choice and choose to do a different kind, as necessary. 

Directory Hierarchies 

Incremental backups are done relative to /; when doing quarterlies, beer 
will change its current working directory to each file system in turn, and do 
the backup relative to This facilitates doing a full restore onto a dif- 
ferent file system, which may be mounted on a different directory while 
doing the restore. 

FILES 

/usr/adm/beer 

Directory containing beer's configuration file, the beer shell file, 
and the necessary subdirectories. 

/usr/adm/beer/tapesets 

Configuration file containing tape set information. 

/ usr/adm/beer/ touch/* 

The directory where the “touch” files are kept. 

/ usr/ adm/beer/log/* 

The directory where the “log” files are kept. Log file names are 
of the form 


monthly .TS.MM-DD 
weekly .TS .MM-DD 
daily .TS.MM-DD-DOW 

where TS is the tape set number, MM is the month, and DD is the 
day. For daily backups, DOW is an abbreviation of the day of the 
week (e.g. “Mon” for Monday). 

SEE ALSO 

bru{\),pr(X), lpr( 1), sh( 1). 

Doing Backups with BEER , by Arnold Robbins. 

DIAGNOSTICS 

Self explanatory. Exit codes are as follows: 

0 Normal exit. Beer ran without any problems. 

1 The person running beer was not the operator. 

2 No files could be found in the /usr/adm/beer/touch directory for 
time stamp comparison. 

3 The operator chose to exit by typing an EOF at a prompt, instead 
of continuing with whatever operation beer was about to do. 
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BUGS 

The current set up for incrementals is somewhat tape intensive, in return for 
increased reliability. 

Since it is a shell file, beer does not do a very good job of error detection or 
recovery. 

The acronym given above in the NAME section is slightly forced. 

Despite the program’s name, the user must supply his own six-packs. 

AUTHOR 

Arnold Robbins 

amold@gatech.{CSNET, UUCP} 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

bootp - server for Internet Bootstrap Protocol (BOOTP) 

SYNOPSIS 

/usr/etc/bootp [ — d ] [ -f ] 

DESCRIPTION 

Bootp is a server which supports the DARPA Internet Bootstrap Protocol 
(BOOTP). This protocol is designed to allow a (possibly diskless) client 
machine to determine its own Internet address, the address of a boot server 
and the name of an appropriate boot file to be loaded and executed. 
BOOTP does not provide the actual transfer of the boot file, which is typi- 
cally done with a simple file transfer protocol such as TFTP. A detailed 
protocol specification for BOOTP is contained in RFC 951, which available 
from the Network Information Center. 

The BOOTP protocol uses UDP/IP as its transport mechanism. The 
BOOTP server receives service requests at the UDP port indicated in the 
“bootp” service description contained in the file letcl services (see ser- 
vices (4)). The BOOTP server is started by inetd( 1M), as configured in the 
inetd.conf file. 

The basic operation of the BOOTP protocol is a single packet exchange as 
follows: 

1) The booting client machine broadcasts a BOOTP request packet to 
the BOOTP server UDP port, using a UDP broadcast or the 
equivalent thereof. The request packet includes the following 
information: 

requester’s Ethernet address 
requester’s Internet address (optional) 
desired server’s name (optional) 
boot file name (optional) 

2) All the BOOTP servers on the same Ethernet wire as the client 
machine receive the client’s request. If the client has specified a 
particular server, then only that server will respond. 

3) The server looks up the requester in its configuration file by Inter- 
net address or Ethernet address, in that order of preference. (The 
BOOTP configuration file is described below.) If the Internet 
address was not specified by the requester and a configuration 
record is not found, the server will look in the /etc/ethers file (see 
ethers(4 )) for an entry with the client’s Ethernet address. If an 
entry is found, the server will check the hostname of that entry 
against the /etc /hosts file (see hosts ( 4)) in order to complete the 
Ethernet address to Internet address mapping. If the BOOTP 
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request does not include the client’s Internet address and the server 
is unable to translate the client’s Ethernet address into an Internet 
address by either of the two methods described, the server will not 
respond to the request. 

4) The server performs name translation on the boot filename 
requested and then checks for the presence of that file. If the file is 
present, then the server will send a response packet to the requester 
which includes the following information: 

the requester’s Internet address 

the server’s Internet address 

the Internet address of a gateway to the server 

the server’s name 

vendor specific information (not defined by the protocol) 

If the boot file is missing, the server will return a response packet 
with a null filename, but only if the request was specifically 
directed to that server. The pathname translation is: if the boot 
filename is rooted, use it as is; else concatenate the root of the boot 
subtree, as specified by the BOOTP configuration file, followed by 
the filename supplied by the requester, followed by a period and 
the requester’s hostname. If that file is not present, remove the 
trailing period and host name and try again. If no boot filename is 
requested, use the default boot file for that host from the 
configuration table. If there is no default specified for that host, 
use the general default boot filename, first with .hostname as a 
suffix and then without. 

Options 

The -d option causes bootp to generate debugging messages. All messages 
from bootp go through sys/ogdflM), the system logging daemon. 

The -f option enables the forwarding function of bootp. Refer to the fol- 
lowing section on Booting Through Gateways for an explanation. 

Bootp Configuration File 

In order to perform its name translation and address resolution functions, 
bootp requires configuration information, which it gets from an ASCII file 
called /usr/etc/bootptab and from other system configuration files like 
I etc/ ethers and /etc/ hosts. Here is a sample bootptab file: 

# 

# /usr/etc/bootptab: database for bootp server 

# 

# Blank lines and lines beginning with ’#’ are ignored. 

# 
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# root of boot subtree 
/usr/local/boot 

# default bootfile 
unix 


# 

# The remainder of this file contains one line per client interface 

# with the information shown by the table headings below. 

# The ’host’ name is also tried as a suffix for the ’bootfile’ 

# when searching the boot directory, (e.g., bootfile.host) 

# 

# host htype haddr iaddr bootfile 

# 

unixbox 1 l:2:3:4:bb:cc 89.0.0.2 

The fields of each line may be separated by variable amounts of white space 
(blanks and tabs). The first section, up to the line beginning ’%%’, defines 
the place where bootp looks for boot files when the client requests a boot 
file using a non-rooted pathname. The second section of the file is used for 
mapping client Ethernet addresses into Internet addresses. The htype field 
should always have a value of 1 for now, which indicates that the hardware 
address is a 48-bit Ethernet address. The haddr field is the Ethernet address 
of the system in question expressed as 6 hex bytes separated by colons. The 
iaddr field is the 32-bit Internet address of the system expressed in standard 
dot notation (4 byte values in decimal, in network order, separated by 
periods). Each line in the second section can also specify a default boot file 
for each specific host. In the example above, if the host called unixbox 
makes a BOOTP request with no boot file specified, the server will select 
the first of the following that it finds: 

/usr/local/boot/unix.unixbox 

/usr/local/boot/unix 

It is not necessary to create a record for every potential client the every 
bootptab file. The only constraint is that bootp will only respond to a 
request from a client if it can deduce the client’s Internet address. There are 
three ways that this can happen: 1) the client already knows his Internet 
address and includes it in the BOOTP request packet, 2) there is an entry in 
/usr/etc/bootptab that matches the client’s Ethernet address or 3) there are 
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entries in the I etc! ethers and /etc /hosts files (or their Yellow Pages 
equivalents) that allow the client’s Ethernet address to be translated into an 
Internet address. 

Booting Through Gateways 

Since the BOOTP request is distributed using a UDP broadcast, it will only 
be received by other hosts on the same Ethernet cable as the client. In some 
cases the client may wish to boot from a host on another network. This can 
be accomplished by using the forwarding function of BOOTP servers on the 
local wire. To use BOOTP forwarding, there must be a bootp process run- 
ning in a gateway machine on the local cable. A gateway machine is sim- 
ply a machine with more than one Ethernet controller board. The gateway 
bootp must be invoked with the -f option to activate forwarding. Such a 
forwarding bootp will resend any BOOTP request it receives that asks for a 
specific host by name, if that host is on a different network from the client 
that sent the request. The BOOTP server forwards the packet using the full 
routing capabilities of the underlying IP layer in the kernel, so the for- 
warded packet will automatically be routed to the requested BOOTP server 
provided that the kernel routing tables contain a route to the destination net- 
work. 

DIAGNOSTICS 

The BOOTP server sends any messages it wants to reach the outside world 
through the system logging daemon, sys/ 0 gd(lM). The actual disposition 
of these messages depends on the configuration of syslogd on the machine 
in question. Consult syslogd( 1M) for further information. 

Bootp can produce the following messages: 

'get interface config' ioctl failed (message) 

'get interface netmask' ioctl failed (message) 

getsockname fails (message) 

forwarding failed (message) 

send failed (message) 

set arp iocd failed 

Each of the above messages mean that a system call has returned 
an error unexpectedly. Such errors usually cause bootp to ter- 
minate. The message will be the result of calling perror{ 3) with 
the errno value that was returned. 

less than two interfaces, -f flag ignored 

Warning only. Means that the -f option was specified on a 
machine that is not a gateway. Forwarding only works on gate- 
ways. 
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request for unknown host xxx from yyy 

Information only. A BOOTP request was received asking for host 
xxx, but that host is not in the host database. The request was gen- 
erated by yyy, which may be given as a host name or an Internet 
address. 

request from xxx for ’fff’ 

Information only. Bootp logs each request for a boot file. The 
means that host xxx has requested boot file fff. 

boot file fff missing 

A request has been received for the boot file fff, but that file 
doesn’t exist. 

replyfile fff 

Information only. Bootp has selected the filejgf as the boot file to 
satisfy a request. 

forward request with gateway address already set (dd.dd.dd.dd) 

The server has received a reply to be forwarded to a requester, but 
some other bootp has already filled himself in as the gateway. 
This is an error in the BOOTP forwarding mechanism. 

missing gateway address 

This means that this bootp has generated a response to a client and 
is trying to send the response directly to the client (i.e. the request 
did not get forwarded by another bootp), but none of the Ethernet 
interfaces on this machine is on the same wire as the client 
machine. This indicates a bug in the BOOTP forwarding mechan- 
ism. 

can’t open /usr/etc/bootptab 

The bootp configuration file is missing or has wrong permissions. 
(re)reading /usr/etc/bootptab 

Information only. Bootp checks the modification date of the 
configuration file on the receipt of each request and rereads it if it 
has been modified since the last time it was read. 

bad hex address: xxx at line nnn of bootptab 
bad internet address: sss at line nnn of bootptab 
string truncated: sss, on line nnn of bootptab 

These messages all mean that the format of the BOOTP 
configuration file is not valid. 

'hosts' table length exceeded 

There are too many lines in the second section of the BOOTP 
configuration file. The current limit is 512. 
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can’t allocate memory 

A call to malloc{ 3) failed. 

gethostbyname(sss) fails (message) 

A call to gethostbyname{ 3N) with the argument sss has failed. 

gethostbyaddr(dd.dd.dd.dd) fails (message) 

A call to gethostbyaddr( 3N) with the argument dd.dd.dd.dd has 
failed. 

can’t find source net for address xxx 

This means that the server has received a datagram with a source 
address that doesn’t make sense. The offending address is printed 
as a 32 bit hexadecimal number xxx. 

SEE ALSO 

inetd(lM), syslogd(lM), tftpd(lM), ethers(4), hosts(4), services(4) 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

brc, bcheckrc - system initialization procedures 

SYNOPSIS 

/etc/brc 

/etc/bcheckrc 

DESCRIPTION 

These shell procedures are executed via entries in /etc/inittab by init( 1M) 
whenever the system is booted (or rebooted). 

First, the bcheckrc procedure checks the status of the root file system. If the 
root file system is found to be bad, bcheckrc repairs it. 

Then, the brc procedure clears the mounted file system table, /etc/mtab and 
puts the entry for the root file system into the mount table. 

After these two procedures have executed, init checks for the initdefau.lt 
value in /etc/inittab. This tells init in which run level to place the system. 
Since initdefault is initially set to 2, the system will be placed in the multi- 
user state via the Ietclrc2 procedure. 

Note that bcheckrc should always be executed before brc. Also, these shell 
procedures may be used for several run-level states. 

SEE ALSO 

fsck(lM), init(lM), rc2(lM), shutdown(lM). 

ORIGIN 

AT&T V.3 
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NAME 

captoinfo - convert a termcap description into a terminfo description 
SYNOPSIS 

captoinfo [-v ...] [— V] [-1] [-w width] file ... 

DESCRIPTION 

captoinfo looks in file for termcap descriptions. For each one found, an 
equivalent terminfo (4) description is written to standard output, along with 
any comments found. A description which is expressed as relative to 
another description (as specified in the termcap tc= field) will be reduced to 
the minimum superset before being output. 

If no file is given, then the environment variable TERMCAP is used for the 
filename or entry. If TERMCAP is a full pathname to a file, only the termi- 
nal whose name is specified in the environment variable TERM is extracted 
from that file. If the environment variable TERMCAP is not set, then the 
file letcltermcap is read. 

-v print out tracing information on standard error as the program 

runs. Specifying additional -v options will cause more detailed 
information to be printed. 

-V print out the version of the program in use on standard error 

and exit. 

—1 cause the fields to print out one to a line. Otherwise, the fields 

will be printed several to a line to a maximum width of 60 
characters. 

-w change the output to width characters. 

FILES 

/usr/lib/terminfo/?/* compiled terminal description database 
CAVEATS 

Certain termcap defaults are assumed to be true. For example, the bell 
character ( terminfo bel ) is assumed to be 'G . The linefeed capability 
(i termcap nl) is assumed to be the same for both cursor down and 
scroll Jorward ( terminfo cudl and ind, respectively.) Padding information 
is assumed to belong at the end of the string. 

The algorithm used to expand parameterized information for termcap fields 
such as cursor _position ( termcap cm, terminfo cup) will sometimes pro- 
duce a string which, though technically correct, may not be optimal. In par- 
ticular, the rarely used termcap operation %n will produce strings that are 
especially long. Most occurrences of these non-optimal strings will be 
flagged with a warning message and may need to be recoded by hand. 
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The short two-letter name at the beginning of the list of names in a termcap 
entry, a hold-over from an earlier version of the UNIX system, has been 
removed. 

DIAGNOSTICS 

tgetent failed with return code n (reason). 

The termcap entry is not valid. In particular, check for an 
invalid ’tc=’ entry. 

unknown type given for the termcap code cc. 

The termcap description had an entry for cc whose type 
was not boolean, numeric or string. 

wrong type given for the boolean (numeric, string) termcap code cc. 

The boolean termcap entry cc was entered as a numeric 
or string capability. 

the boolean (numeric, string) termcap code cc is not a valid name. 

An unknown termcap code was specified. 

tgetent failed on TERM=term. 

The terminal type specified could not be found in the 
termcap file. 

TERM=term: cap cc (info ii) is NULL: REMOVED 

The termcap code was specified as a null string. The 
correct way to cancel an entry is with an ’@’, as in 
’:bs@:’. Giving a null string could cause incorrect 
assumptions to be made by the software which uses 
termcap or terminfo. 

a function key for cc was specified, but it already has the value w. 

When parsing the ko capability, the key cc was specified 
as having the same value as the capability cc, but the key 
cc already had a value assigned to it. 

the unknown termcap name cc was specified in the ko termcap capability. 

A key was specified in the ko capability which could not 
be handled. 

the vi character v (info ii) has the value xx, but ma gives n. 

The ma capability specified a function key with a value 
different from that specified in another setting of the same 
key. 

the unknown vi key v was specified in the ma termcap capability. 

A vi (1) key unknown to captoinfo was specified in the ma 
capability. 
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Warning: termcap sg (nn) and termcap ug (nn) had different values. 

terminfo assumes that the sg (now xmc) and ug values 
were the same. 

Warning: the string produced for ii may be inefficient. 

The parameterized string being created should be rewrit- 
ten by hand. 

Null termname given. 

The terminal type was null. This is given if the environ- 
ment variable TERM is not set or is null. 

cannot open file for reading. 

The specified file could not be opened. 

SEE ALSO 

infocmp(lM), tic(lM). 

curses (3X), terminfo(4) in the Programmer’ s Reference Manual. 

Chapter 9 in the Programmer' s Guide. 

NOTES 

captoinfo should be used to convert termcap entries to terminfo(4 ) entries 
because the termcap database (from earlier versions of UNIX System V) 
may not be supplied in future releases. 

ORIGIN 

AT&T V.3 
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NAME 

chkconfig - configuration state checker 
SYNOPSIS 

/etc/chkconfig [ flag [ on I off ]] 

DESCRIPTION 

chkconfig with no arguments, prints the state (on or off) of every 
configuration flag found in letc/config. A flag is considered on if its file 
contains the string “on” and off otherwise. 

If flag is specified as the sole argument, chkconfig sets the exit status to 0 if 
flag is on and sets the status to 1 if flag is off or nonexistent. The exit status 
can be used by csh{ 1) and sh(l) scripts to test the state of a flag. Here is a 
sh(l) example: 

if /etc/chkconfig verbose ; then 
echo "It’s on" 
else 

echo "It’s off' 
fi 

The optional third argument allows the setting of the specified flag. 

These flags are used for determining the configuration status of the various 
available subsystems and daemons during system startup and during system 
operation. 

FILES 

/etc/config - directory containing configuration flag files 
SEE ALSO 

cron(lM), rcO(lM), rc2(lM). 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

chroot - change root directory for a command 
SYNOPSIS 

/etc/chroot newroot command 
DESCRIPTION 

chroot causes the given command to be executed relative to the new root. 
The meaning of any initial slashes (/) in the path names is changed for the 
command and any of its child processes to newroot. Furthermore, upon 
execution, the initial working directory is newroot. 

Notice, however, that if you redirect the output of the command to a file: 
chroot newroot command >x 

will create the file x relative to the original root of the command, not the 
new one. 

The new root path name is always relative to the current root: even if a 
chroot is currently in effect, the newroot argument is relative to the current 
root of the running process. 

This command can be run only by the super-user. 

CAVEAT 

chroot has the side effect of changing the location of shared libraries. 
Shared libraries should exist in the new root for any commands that require 
them. For example, most commands are linked with the shared version of 
libc, so a copy of /lib/libc_s would be required in the new root in order for 
them to run. 

SEE ALSO 

cd(l) in the User’s Reference Manual. 
chroot(2) in the Programmer' s Reference Manual. 

BUGS 

One should exercise extreme caution when referencing device files in the 
new root file system. 

ORIGIN 

AT&T V.3 


1 - 


September 1988 


Version 3.0 



CHRTBL(IM) 


Silicon Graphics 


CHRTBL(1M) 


NAME 

chrtbl - generate character classification and conversion tables 

SYNOPSIS 

chrtbl [file] 

DESCRIPTION 

The chrtbl command creates a character classification table and an 
upper/lower-case conversion table. The tables are contained in a byte-sized 
array encoded such that a table lookup can be used to determine the charac- 
ter classification of a character or to convert a character (see ctype(3C)). 
The size of the array is 257*2 bytes: 257 bytes are required for the 8-bit 
code set character classification table and 257 bytes for the upper- to 
lower-case and lower- to upper-case conversion table. 

chrtbl reads the user-defined character classification and conversion infor- 
mation from file and creates two output files in the current directory. One 
output file, ctype.c (a C-language source file), contains the 257*2-byte 
array generated from processing the information from file. You should 
review the content of ctype.c to verify that the array is set up as you had 
planned. (In addition, an application program could use ctype.c .) The first 
257 bytes of the array in ctype.c are used for character classification. The 
characters used for initializing these bytes of the array represent character 
classifications that are defined in /usr/include/ctype.h; for example, _L 
means a character is lower case and _B means the character is both a 
spacing character and a blank. The last 257 bytes of the array are used for 
character conversion. These bytes of the array are initialized so that charac- 
ters for which you do not provide conversion information will be converted 
to themselves. When you do provide conversion information, the first value 
of the pair is stored where the second one would be stored normally, and 
vice versa; for example, if you provide <0x41 0x61>, then 0x61 is stored 
where 0x41 would be stored normally, and 0x61 is stored where 0x41 
would be stored normally. 

The second output file (a data file) contains the same information, but is 
structured for efficient use by the character classification and conversion 
routines (see ctype(3C)). The name of this output file is the value of the 
character classification chrclass read in from file. This output file must be 
installed in the /lib/chrclass directory under this name by someone who is 
super-user or a member of group bin. This file must be readable by user, 
group, and other; no other permissions should be set. To use the character 
classification and conversion tables on this file, set the environmental vari- 
able CHRCLASS (see environ (5)) to the name of this file and export the 
variable. For example, if the name of this file (and character class) is xyz, 
sh(Y) users should issue the commands: 

CHRCLASS=xyz ; export CHRCLASS 
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and csh( 1) users should issue the command: 
setenv CHRCLASS xyz 

If no input file is given, or if the argument - is encountered, chrtbl reads 
from the standard input file. 

The syntax of file allows the user to define the name of the data file created 
by chrtbl, the assignment of characters to character classifications and the 
relationship between upper- and lower-case letters. The character 
classifications recognized by chrtbl are: 


chrclass 

name of the data file to be created by chrtbl. 

isupper 

character codes to be classified as upper-case 
letters. 

islower 

character codes to be classified as lower-case 
letters. 

isdigit 

character codes to be classified as numeric. 

isspace 

character codes to be classified as a spacing (delim- 
iter) character. 

ispunct 

character codes to be classified as a punctuation 
character. 

iscntrl 

character codes to be classified as a control charac- 
ter. 

isblank 

character code for the space character. 

isxdigit 

character codes to be classified as hexadecimal 
digits. 

ul 

relationship between upper- and lower-case charac- 
ters. 


Any lines with the number sign (#) in the first column are treated as com- 
ments and are ignored. Blank lines are also ignored. 

A character can be represented as a hexadecimal or octal constant (for 
example, the letter a can be represented as 0x61 in hexadecimal or 0141 in 
octal). Hexadecimal and octal constants may be separated by one or more 
space and tab characters. 

The dash character (-) may be used to indicate a range of consecutive 
numbers. Zero or more space characters may be used for separating the 
dash character from the numbers. 

The backslash character (\) is used for line continuation. Only a carriage 
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return is permitted after the backslash character. 

The relationship between upper- and lower-case letters (ul) is expressed as 
ordered pairs of octal or hexadecimal constants: <upper-case_character 
lower-case _character>. These two constants may be separated by one or 
more space characters. Zero or more space characters may be used for 
separating the angle brackets (< >) from the numbers. 

EXAMPLE 

The following is an example of an input file used to create the ASCII code 
set definition table on a file named ascii, 
chrclass ascii 
isupper 0x41 - 0x5a 
islower 0x61 - 0x7a 
isdigit 0x30 - 0x39 
isspace 0x20 0x9 - Oxd 
ispunct 0x21 - 0x2f 0x3a - 0x40 \ 

0x5b - 0x60 0x7b - 0x7e 

iscntrl 0x0 - Ox If 0x7f 

isblank 0x20 

isxdigit 0x30 - 0x39 0x61 - 0x66 \ 

0x4 1 - 0x46 

ul <0x41 0x61> <0x42 0x62> <0x43 0x63> \ 

<0x44 0x64> <0x45 0x65> <0x46 0x66> \ 

<0x47 0x67> <0x48 0x68> <0x49 0x69> \ 

<0x4a 0x6a> <0x4b 0x6b> <0x4c 0x6c> \ 

<0x4d 0x6d> <0x4e 0x6e> <0x4f 0x6f> \ 

<0x50 0x70> <0x51 0x7 1> <0x52 0x72> \ 

<0x53 0x73> <0x54 0x74> <0x55 0x75> \ 

<0x56 0x76> <0x57 0x77> <0x58 0x78> \ 

<0x59 0x79> <0x5a 0x7a> 

FILES 

/lib/chrclass/* data file containing character classification and conver- 
sion tables created by chrtbl 

/usr/include/ctype.h 

header file containing information used by character 
classification and conversion routines 

SEE ALSO 

environ(5). 

ctype(3C) in the Programmer’ s Reference Manual . 

DIAGNOSTICS 

The error messages produced by chrtbl are intended to be self-explanatory. 
They indicate errors in the command line or syntactic errors encountered 
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within the input file. 

ORIGIN 

AT&T V.3.1 


Version 3.0 
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NAME 

ckbupscd - check file system backup schedule 
SYNOPSIS 

/etc/ckbupscd [ -m ] 

DESCRIPTION 

ckbupscd consults the file /etc/bupsched and prints the file system lists 
from lines with date and time specifications matching the current time. If 
the -m flag is present an introductory message in the output is suppressed 
so that only the file system lists are printed. Entries in the /etc/bupsched file 
are printed under the control of cron. 

The System Administration commands bupsched/schedcheck are provided 
to review and edit the /etc/bupsched file. 

The file /etc/bupsched should contain lines of 4 or more fields, separated 
by spaces or tabs. The first 3 fields (the schedule fields) specify a range of 
dates and times. The rest of the fields constitute a list of names of file sys- 
tems to be printed if ckbupscd is run at some time within the range given by 
the schedule fields. The general format is: 

time[,time] day[,day] month[,month] fsyslist 
where: 

time Specifies an hour of the day (0 through 23), matching any time 
within that hour, or an exact time of day ( 0:00 through 23:59). 

day Specifies a day of the week ( sun through sat) or day of the month 
(7 through 31). 

month Specifies the month in which the time and day fields are valid. 
Legal values are the month numbers (7 through 72). 

fsyslist The rest of the line is taken to be a file system list to print. 

Multiple time, day, and month specifications may be separated by commas, 
in which case they are evaluated left to right. 

An asterisk (*) always matches the current value for that field. 

A line beginning with a sharp sign (#) is interpretted as a comment and 
ignored. 

The longest line allowed (including continuations) is 1024 characters. 
EXAMPLES 

The following are examples of lines which could appear in the 
/etc/bupsched file. 

06:00-09:00 fri 1,2,3,4,5,6,7,8,9,10,11 /applic 

Prints the file system name lapplic if ckbupscd is run between 


-1 - 


September 1988 


Version 3.0 



CKBUPSCD(IM) Silicon Graphics CKBUPSCD(IM) 

6:00am and 9:00am any Friday during any month except 
December. 

00:00-06:00,16:00-23:59 1,2, 3, 4, 5, 6,7 1,8 / 

Prints a reminder to backup the root (/) file system if ckbupscd is 
run between the times of 4:00pm and 6:00am during the first 
week of August or January. 

FILES 

/etc/bupsched specification file containing times and file system to back 
up 

SEE ALSO 

cron(lM). 

echo(l), sh(l), sysadm(l) in the User’ s Reference Manual. 

BUGS 

ckbupscd will report file systems due for backup if invoked any time in the 
window. It does not know that backups may have just been taken. 

ORIGIN 

AT&T V.3 
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NAME 

clri - clear i-node 
SYNOPSIS 

/etc/clri special i-number ... 

DESCRIPTION 

clri writes nulls on the inode table entry for i-number. This effectively 
eliminates the i-node at that address. Special is the device name on which a 
file system has been defined. After clri is executed, any blocks in the 
affected file will show up as “not accounted for” when /rafc(lM) is run 
against the file-system. The i-node may be allocated to a new file. 

Read and write permission is required on the specified special device. 

This command is used to remove a file which appears in no directory; that 
is, to get rid of a file which cannot be removed with the rm command. 

SEE ALSO 

fsck(lM), fsdb(lM), ncheck(lM). 

fs(4) in the Programmer' s Reference Manual. 

rm(l) in the User’ s Reference Manual. 

WARNINGS 

If the file is open for writing, clri will not work. The file system containing 
the file should be NOT mounted. 

If clri is used on the i-node number of a file that does appear in a directory, 
it is imperative to remove the entry in the directory at once, since the i-node 
may be allocated to a new file. The old directory entry, if not removed, 
continues to point to the same file. This sounds like a link, but does not 
work like one. Removing the old entry destroys the new file. 

ORIGIN 

AT&T V.3 
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NAME 

cron - clock daemon 

SYNOPSIS 

/etc/cron 

DESCRIPTION 

cron executes commands at specified dates and times. Regularly scheduled 
commands can be specified according to instructions found in crontab files 
in the directory /usr/spool/cron/crontabs. Users can submit their own 
crontab file via the crontab( 1) command. Commands which are to be exe- 
cuted only once may be submitted via the at{ 1) command. 

cron only examines crontab files and at command files during process ini- 
tialization and when a file changes via crontab or at. This reduces the over- 
head of checking for new or changed files at regularly scheduled intervals. 

Since cron never exits, it should be executed only once. This is done rou- 
tinely through /etc/rc2.d/S75cron at system boot time. /usr/lib/cron/FIFO 
is used as a lock file to prevent the execution of more than one cron. 

FILES 

/usr/lib/cron main cron directory 
/usr/lib/cron/FIFO 

used as a lock file 

/usr/lib/cron/log accounting information 
/usr/spool/cron spool area 

SEE ALSO 

at(l), crontab(l), sh(l) in the U ser’ s Reference Manual. 

DIAGNOSTICS 

A history of all actions taken by cron are recorded in /usr/lib/cron/log. 

ORIGIN 

AT&T V.3 
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NAME 

dd - convert and copy a file 

SYNOPSIS 

dd [option=value] ... 

DESCRIPTION 

dd copies the specified input file to the specified output with possible 
conversions. The standard input and output are used by default. The input 
and output block size may be specified to take advantage of raw physical 
I/O. 

option values 

if =file input file name; standard input is default 

of =file output file name; standard output is default 

ibs=n input block size n bytes (default 512) 

obs=n output block size (default 512) 

bs=« set both input and output block size, superseding ibs and 

obs ; also, if no conversion is specified, it is particularly 
efficient since no in-core copy need be done 
cbs=n conversion buffer size 

skip=n skip n input blocks before starting copy 

seek=n seek n blocks from beginning of output file before copying 

iseek=n seek n blocks from beginning of input file before copying 

count=n copy only n input blocks 
conv=ascii convert EBCDIC to ASCII 
ebcdic convert ASCII to EBCDIC 
ibm slightly different map of ASCII to EBCDIC 
lease map alphabetics to lower case 
ucase map alphabetics to upper case 
swab swap every pair of bytes 
noerror 

do not stop processing on an error 
sync pad every input block to ibs 
block convert Ascn to blocked Ascn 

unblock 

convert blocked Ascn to Ascn 
....... several comma-separated conversions 

Where sizes are specified, a number of bytes is expected. A number may 
end with k, b, or w to specify multiplication by 1024, 512, or 2, respec- 
tively; a pair of numbers may be separated by x to indicate multiplication. 

ebs is used only if conv=ascii or conv=ebcdic is specified. In the former 
case, ebs characters are placed into the conversion buffer (converted to 
ASCII). Trailing blanks are trimmed and a new-line added before sending 
the line to the output. In the latter case, ASCII characters are read into the 
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conversion buffer (converted to EBCDIC). Blanks are added to make up an 
output block of size cbs. 

After completion, dd reports the number of whole and partial input and out- 
put blocks. 

DIAGNOSTICS 

f+p blocks in(out) numbers of full and partial blocks read(written) 

ORIGIN 

AT&T V.3 


Version 3.0 
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NAME 

devinfo - print device specific information 
SYNOPSIS 

/usr/lbin/devinfo -i I -p special 
DESCRIPTION 

The devinfo command is used to print device specific information about 
disk devices on standard out. 

The options have the following effect: 

-i option will print the following device information: 

Device name Software version 

Drive identification number Device blocks per cylinder 

Device bytes per block Number of device partitions with 

a block size greater than zero 
-p will print the following device partition information: 

Device name Device major and minor numbers 

Partition start block Number of blocks allocated to 

the partition 

Partition flag Partition tag 

The command is used by various other commands to obtain device specific 
information for the making of file systems and determining partition infor- 
mation. 

SEE ALSO 

prtvtoc(lM). 

ORIGIN 

AT&T V.3 
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NAME 

devnm - device name 

SYNOPSIS 

/etc/devnm [names] 

DESCRIPTION 

devnm identifies the special file associated with the mounted file system 
where the argument name resides. 

This command is most commonly used by /etc/brc (see ftrc(lM)) to con- 
struct a mount table entry for the root device. 

EXAMPLE 

The command: 

/etc/devnm /usr 
produces 

/dev/dsk/ips0d0s2 usr 
if /usr is mounted on /dev/dsk/ips0d0s2. 

FILES 

/dev/dsk/* 

/etc/mtab 

SEE ALSO 

brc(lM). 

ORIGIN 

AT&T V.3 
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NAME 

diskusg - generate disk accounting data by user ID 
SYNOPSIS 

/usr/lib/acct/diskusg [options] [files] 

DESCRIPTION 

diskusg generates intermediate disk accounting information from data in 
files, or the standard input if omitted, diskusg output lines on the standard 
output, one per user, in the following format: uid login #blocks 

where 

uid the numerical user ID of the user. 

login the login name of the user; and 

#blocks the total number of disk blocks allocated to this user. 

diskusg normally reads only the inodes of file systems for disk accounting. 
In this case, files are the special filenames of these devices. 

diskusg recognizes the following options: 

-s the input data is already in diskusg output format, diskusg 

combines all lines for a single user into a single line. 

verbose. Print a list on standard error of all files that are 
charged to no one. 

ignore the data on those file systems whose file system name 
is in fnmlist. fnmlist is a list of file system names separated 
by commas or enclosed within quotes, diskusg compares 
each name in this list with the file system name stored in the 
volume ID (see labelit(lM)). 

use file as the name of the password file to generate login 
names, letclpasswd is used by default. 

write records to file of files that are charged to no one. 
Records consist of the special file name, the inode number, 
and the user ID. 

The output of diskusg is normally the input to acctdisk (see acct(lM)) 
which generates total accounting records that can be merged with other 
accounting records, diskusg is normally run in dodisk (see acc?s/i(lM)). 

EXAMPLES 

The following will generate daily disk accounting information for root on 
/dev/dsk/ipsOdOsO : 

/usr/lib/acct/diskusg /dev/dsk/ipsOdOsO | acctdisk > disktacct 
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FILES 

/etc/passwd used for user ID to login name conversions 

SEE ALSO 

acct(lM), acctsh(lM) 

acct(4) in the Programmer’ s Reference Manual 

ORIGIN 

AT&T V.3.1 


Version 3.0 
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NAME 

distcp - copy software distribution 
SYNOPSIS 

distcp [ -cnrsv ] from to 
DESCRIPTION 

distcp copies all or part of a distribution from one location to another. It 
can also compare two distributions or parts of a distribution. Options: 

-c Compare from and to rather than copying. 

-s Compare silently; exit status only. 

-v Verbose; report names as files are copied. 

-n No standalone files sa and mr. 

-r Retension tape before reading or writing. 

A software product can reside on magnetic tape or in disk files. A product 
named foo will consist several physical files. The file by which the product 
is identified is called a product descriptor and is named foo. The other files 
that make up the product are called /oo.idb, and foo .image for each image 
in the product. 

There are two additional files that are used along with the product files. 
One of these is called sa, and contains the standalone tools used during 
software installation. The other is called mr, and may or may not contain 
additional components of the standalone environment. Compatability issues 
require its presence even if it is empty. 

The integrity of the software distribution will be lost if any of these files are 
altered in any way. 

The from and to arguments indicate where to copy the distribution from and 
to. They can be a tape device, the pathname of a product descriptor file, or 
the pathname of a directory containing several products. Any of these 
names may be prefixed with hostname: or user@hostname : to access a 
remote machine. 

The two standalone files sa and mr are included in every copy, unless the 
-n flag is given. 

It is not possible to copy more than one product to tape, therefore also not 
possible read more than one product from tape. 

A collection of software products copied to a disk directory, along with a 
single copy of the standalone files sa and mr , will make a convenient distri- 
bution source for the inst command in a network environment. 
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AUTHOR 

Donl Mathis 

SEE ALSO 

inst(lm), versions(lm). 

ORIGIN 

Silicon Graphics, Inc. 


Version 3.0 
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NAME 

du - summarize disk usage 
SYNOPSIS 

du t -sar ] [ names ] 

DESCRIPTION 

du reports the number of blocks (512 bytes per block) contained in all files 
and (recursively) directories within each directory and file specified by the 
names argument. The block count includes the indirect blocks of the file, 
which may not be correct for the given underlying filesystem. If names is 
missing, the current directory is used. 

The optional arguments are as follows: 

-s causes only the grand total (for each of the specified names) to be 
given. 

-a causes an output line to be generated for each file. 

If neither -s or -a is specified, an output line is generated for each directory 
only. 

-r will cause du to generate messages about directories that cannot be 
be read, files that cannot be opened, etc., rather than being silent 
(the default). 

A file with two or more links is only counted once. 

BUGS 

If the -a option is not used, non-directories given as arguments are not 
listed. 

If there are links between files in different directories where the directories 
are on separate branches of the file system hierarchy, du will count the 
excess files more than once. 

Files with holes in them will get an incorrect block count. 
du should not know about the underlying filesystem implementation. 

ORIGIN 

AT&T V.3 
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NAME 

dvhtool - command to modify disk volume header information 

SYNOPSIS 

/etc/dvhtool 

[—v [add unix Jle dvh Jde ] [creat unix Jile dvh Jle] 

[delete dvh Jile ] [list]] [header_filename] 

DESCRIPTION 

Dvhtool allows modification of the disk volume header information, a block 
located at the beginning of all disk media. The disk volume header consists 
of three main parts: the device parameters, the partition table, and the 
volume directory. The volume directory is used to locate files kept in the 
volume header area of the disk for standalone use. The partition table 
describes the logical device partitions. The device parameters describe the 
specifics of a particular disk drive. 

Note that it is necessary to be superuser in order to use dvhtool. 

Invoked with no arguments, dvhtool allows the user to interactively exam- 
ine and modify the disk volume header. The read command prompts for 
the name of the device file for the volume header to be worked on. This 
may be /dev/vh for the header of the root disk, or the header name of 
another disk in the Idev/dsk directory, see vh(7m). It then reads the volume 
header from the specified device. 

The vd, pt, and dp commands first list their respective portions of the 
volume header and them prompt for modifications. The write command 
writes the possibly modified volume header to the device. 

NOTE: use of dvhtool for changing partitions and parameters is not recom- 
mended. Dvhtool does not update the copy of the volume header used by 
the disk driver, so changes made by it do not become effective until the sys- 
tem is next rebooted. This may give rise to unexpected results. 

Parameters and partitions should be manipulated with fx(lm). 

COMMAND LINE ARGUMENTS 

Invoked with arguments, dvhtool reads the volume header, performs the 
specified operations, and then writes the volume header. If no 
header_filename is specified on the command line, /dev/vh is used. 

The following describes dvhtool’ s command line arguments. 

The -v flag provides four options for modifying the volume directory infor- 
mation in the disk volume header. The creat option allows creation of a 
volume directory entry with the name dvh Jile and the contents of unix Jle. 
If an entry already exists with the name dvh Jle, it is overwritten with the 
new contents. The add option adds a volume directory entry with the name 
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dvh Jile and the contents of unixjile. Unlike the creat option, the add 
options will not overwrite an existing entry. The delete option removes the 
entry named dvh Jile, if it exists, from the volume directory. The list option 
lists the current volume directory contents. 

SEE ALSO 

vh(7m) 

fx(lm) 

BUGS 

Should update the disk driver in-core volume header. 

ORIGIN 

MIPS Computer Systems 


Version 3.0 
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NAME 

fingerd - remote user information server 

SYNOPSIS 

/usr/etc/fingerd 

DESCRIPTION 

Fingerd is a simple protocol based on RFC742 that provides an interface to 
the Name and Finger programs at several network sites. The program is 
supposed to return a friendly, human-oriented status report on a particular 
person. There is no required format and the protocol consists mostly of 
specifying a single “command line”. 

Fingerd listens for TCP requests at port 79. Once connected it reads a sin- 
gle command line terminated by a <CRLF> which is prefixed with ’-y’ and 
passed to finger(\). Fingerd closes its connection as soon as the output is 
finished. It can be invoked at a remote site using the finger command by 
’finger user@ remote’. 

SEE ALSO 

finger(l), inetd(lM), telnet(lC) 

BUGS 

Connecting directly to the server from a TIP or an equally narrow-minded 
TELNET-protocol user program can result in meaningless attempts at 
option negotiation being sent to the server, which will foul up the command 
line interpretation. Fingerd should be taught to filter out IAC’s and perhaps 
even respond negatively (IAC WON’T) to all option commands received. 

ORIGIN 

4.3BSD 
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NAME 

fsck, dfsck - check and repair file systems 
SYNOPSIS 

/etc/fsck [— y] [— n] [-SX] [— SX] [-t file] [-q] [-D] [-f] [-b] [file- 
systems ] 

/etc/dfsck [options 1] fsysl ... - [options2] fsys2 ... 

DESCRIPTION 

Fsck 

fsck audits and interactively repairs inconsistent conditions for file systems. 
If the file system is found to be consistent, the number of files, blocks used, 
and blocks free are reported. If the file system is inconsistent the user is 
prompted for concurrence before each correction is attempted. It should be 
noted that most corrective actions will result in some loss of data. The 
amount and severity of data loss may be determined from the diagnostic 
output. The default action for each correction is to wait for the user to 
respond yes or no. If the user does not have write permission fsck defaults 
to a -n action. 

The following options are accepted by fsck. 

-y Assume a yes response to all questions asked by fsck. 

-n Assume a no response to all questions asked by fsck', do not open 
the file system for writing. 

-sX Ignore the actual free list and (unconditionally) reconstruct a new 
one by rewriting the super-block of the file system. The file system 
should be unmounted while this is done; if this is not possible, care 
should be taken that the system is quiescent and that it is rebooted 
immediately afterwards. This precaution is necessary so that the 
old, bad, in-core copy of the superblock will not continue to be used, 
or written on the file system. 

The — sX option allows for creating an optimal free-list organization. 

If X is not given, the values used when the file system was created 
are used. The format of X is cylinder size:gap size. 

— SX Conditionally reconstruct the free list. This option is like — sX above 
except that the free list is rebuilt only if there were no discrepancies 
discovered in the file system. Using -S will force a no response to 
all questions asked by fsck. This option is useful for forcing free list 
reorganization on uncontaminated file systems. 

-t If fsck cannot obtain enough memory to keep its tables, it uses a 
scratch file. If the -t option is specified, the file named in the next 
argument is used as the scratch file, if needed. Without the -t flag, 
fsck will prompt the user for the name of the scratch file. The file 
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chosen should not be on the file system being checked, and if it is 
not a special file or did not already exist, it is removed when fsck 
completes. 

-q Quiet fsck. Do not print size-check messages. Unreferenced fifos 
will silently be removed. If fsck requires it, counts in the superblock 
will be automatically fixed and the free list salvaged. 

-D Directories are checked for bad blocks. Useful after system crashes. 

-f Fast check. Check block and sizes and check the free list. The free 
list will be reconstructed if it is necessary. 

-b Reboot. If the file system being checked is the root file system and 
modifications have been made, then either remount the root file sys- 
tem or reboot the system. A remount is done only if there was 
minor damage. 

If no file-systems are specified, fsck will read a list of default file systems 
from the file /etc/fstab. 

Inconsistencies checked are as follows: 

1. Blocks claimed by more than one i-node or the free list. 

2. Blocks claimed by an i-node or the free list outside the 
range of the file system. 

3. Incorrect link counts. 

4. Size checks: 

Incorrect number of blocks. 

Directory size not 16-byte aligned. 

5. Bad i-node format. 

6. Blocks not accounted for anywhere. 

7. Directory checks: 

File pointing to unallocated i-node. 

I-node number out of range. 

8. Super Block checks: 

More than 65536 i-nodes. 

More blocks for i-nodes than there are in the file 
system. 

9. Bad free block list format. 

10. Total free block and/or free i-node count incorrect. 

Orphaned files and directories (allocated but unreferenced) are, with the 
user’s concurrence, reconnected by placing them in the lost+found direc- 
tory, if the files are nonempty. The user will be notified if the file or direc- 
tory is empty or not. Empty files or directories are removed, as long as the 
-n option is not specified, fsck will force the reconnection of nonempty 
directories. The name assigned is the i-node number. The only restriction 
is that the directory lost+found must preexist in the root of the file system 
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being checked and must have empty slots in which entries can be made. 
This is accomplished by making lost+found, copying a number of files to 
the directory, and then removing them (before fsck is executed). 

Checking the raw device is almost always faster and should be used with 
everything but the root file system. 

Dfsck 

Dfsck should not be used to check the root file system. 

Dfsck allows two file system checks on two different drives simultaneously. 
optionsl and options 2 are used to pass options to fsck for the two sets of file 
systems. A - is the separator between the file system groups. 

The dfsck program permits a user to interact with two fsck programs at 
once. To aid in this, dfsck will print the file system name for each message 
to the user. When answering a question from dfsck , the user must prefix the 
response with a 1 or a 2 (indicating that the answer refers to the first or 
second file system group). 

FILES 

/etc/fstab contains default list of file systems to check. 

SEE ALSO 

checkfsys(lM), mkfs(lM), ncheck(lM), 

uadmin(2), fstab(4), fs(4) in the Programmer’ s Reference Manual. 

BUGS 

I-node numbers for . and . . in each directory are not checked for validity. 

ORIGIN 

AT&T V.3 


September 1988 
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NAME 

fsstat - report file system status 
SYNOPSIS 

/etc/fsstat special_file 
DESCRIPTION 

fsstat reports on the status of the file system on special Jile . During startup, 
this command is used to determine if the file system needs checking before 
it is mounted, fsstat succeeds if the file system is unmounted and appears 
okay. For the root file system, it succeeds if the file system is active and not 
marked bad. 

SEE ALSO 

fs(4) in the Programmer’ s Reference Manual. 

DIAGNOSTICS 

The command has the following exit codes: 

0 - the file system is not mounted and appears okay, 

(except for root where 0 means mounted and okay). 

1 - the file system is not mounted and needs to be checked. 

2 - the file system is mounted. 

3 - the command failed. 

ORIGIN 

AT&T V.3 
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NAME 

fstyp - determine file system identifier 

SYNOPSIS 

fstyp special 

DESCRIPTION 

fstyp allows the user to determine the file system identifier of mounted or 
unmounted file systems using heuristic programs. The file system type is 
required by mount( 2) and sometimes by mount{ 1M) to mount file systems 
of different types. 

The directory /etc/fstyp.d contains a program for each file system type to be 
checked; each of these programs applies some appropriate heuristic to 
determine whether the supplied special file is of the type for which it 
checks. If it is, the program prints on standard output the usual file-system 
identifier for that type and exits with a return code of 0; otherwise it prints 
error messages on standard error and exits with a non-zero return code. 
fstyp runs the programs in /etc/fstyp.d in alphabetical order, passing special 
as an argument; if any program succeeds, its file-system type identifier is 
printed and fstyp exits immediately. If no program succeeds, fstyp prints 
"Unknown_fstyp" to indicate failure. 

WARNING 

The use of heuristics implies that the result of fstyp is not guaranteed to be 
accurate. 

SEE ALSO 

mount/ 1M). 

mount(2), sysfs(2) in the Programmer' s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

ftpd - DARPA Internet File Transfer Protocol server 
SYNOPSIS 

/usr/etc/ftpd [ -d ] [ -1 ] [ -ttimeout ] 

DESCRIPTION 

Ftpd is the DARPA Internet File Transfer Prototocol server process. The 
server uses the TCP protocol and listens at the port specified in the “ftp” 
service specification; see services( 4). 

If the -d option is specified, debugging information is written to the syslog. 

If the -1 option is specified, each ftp session is logged in the syslog. 

The ftp server will timeout an inactive session after 15 minutes. If the -t 
option is specified, the inactivity timeout period will be set to timeout. 

The ftp server currently supports the following ftp requests; case is not dis- 
tinguished. 

Request Description 

ABOR abort previous command 

ACCT specify account (ignored) 

ALLO allocate storage (vacuously) 

APPE append to a file 

CDUP change to parent of current working directory 

CWD change working directory 

DELE delete a file 

HELP give help information 

LIST give list files in a directory (‘ ‘Is -lg’ ’) 

MKD make a directory 

MODE specify data transfer mode 

NLST give name list of files in directory (“Is”) 

NOOP do nothing 

PASS specify password 

PASV prepare for server-to-server transfer 

PORT specify data connection port 

PWD print the current working directory 
QUIT terminate session 

RETR retrieve a file 

RMD remove a directory 

RNFR specify rename-from file name 

RNTO specify rename-to file name 

STOR store a file 

STOU store a file with a unique name 

STRU specify data transfer structure 

TYPE specify data transfer type 
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USER 

specify user name 

XCUP 

change to parent of current working directory 

XCWD 

change working directory 

XMKD 

make a directory 

XPWD 

print the current working directory 

XRMD 

remove a directory 


The remaining ftp requests specified in Internet RFC 959 are recognized, 
but not implemented. 

The ftp server will abort an active file transfer only when the ABOR com- 
mand is preceded by a Telnet "Interrupt Process" (IP) signal and a Telnet 
"Synch" signal in the command Telnet stream, as described in Internet RFC 
959. 

Ftpd interprets file names according to the “globbing” conventions used by 
csh( 1). This allows users to utilize the metacharacters “*?[](}'”. 

Ftpd authenticates users according to three rules. 

1) The user name must be in the password data base, /etc/passwd, and 
not have a null password. In this case a password must be pro- 
vided by the client before any file operations may be performed. 

2) The user name must not appear in the file letclftpusers. 

3) If the user name is “anonymous” or “ftp”, an anonymous ftp 
account must be present in the password file (user “ftp”). In this 
case the user is allowed to log in by specifying any password (by 
convention this is given as the client host’s name). 

In the last case, ftpd takes special measures to restrict the client’s access 
privileges. The server performs a chroot{ 2) command to the home direc- 
tory of the “ftp” user. In order that system security is not breached, it is 
recommended that the “ftp” subtree be constructed with care; the follow- 
ing rales are recommended. 

'ftp) Make the home directory owned by “ftp” and unwritable by any- 
one. 

'ftp/bin) 

Make this directory owned by the super-user and unwritable by 
anyone. The program fo(l) must be present to support the list 
commands. This program should have mode 111 (see chmodiYj). 

'ftp/etc) Make this directory owned by the super-user and unwritable by 
anyone. The files passwd( 5) and group (5) must be present for the 
Is command to work properly. These files should be mode 444. 

'ftp/pub) 

Make this directory owned by “ftp”. If local users and remote 
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anonymous users are allowed to write in this directory, change the 
directory’s mode to 111 . Users can then place files which are to be 
accessible via the anonymous account in this directory. If write 
accesses are to be denied, change the directory’s mode to 555. 

SEE ALSO 

ftp(lC), syslogd(lM) 

BUGS 

The anonymous account is inherently dangerous and should avoided when 
possible. 

The server must run as the super-user to create sockets with privileged port 
numbers. It maintains an effective user id of the logged in user, reverting to 
the super-user only when binding addresses to sockets. The possible secu- 
rity holes have been extensively scrutinized, but are possibly incomplete. 

ORIGIN 

4.3BSD 


September 1988 
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NAME 

fuser - identify processes using a file or file structure 
SYNOPSIS 

/etc/fuser [-ku] files [-] [[-ku] files] 

DESCRIPTION 

fuser outputs the process IDs of the processes that are using the files 
specified as arguments. Each process ID may be followed by a letter code, 
interpreted as follows: if the process is using the file as its current direc- 
tory, the code is c; if the file is the process’s root directory, the code is r. 
No code means the process is holding the file open. 

If file names a block special device containing a mounted file system, all 
processes using any file on that device are listed. If file has the form 
hostname pathname and names a mounted NFS filesystem, all processes 
using any file in that system are listed. 

The following options may be used with fuser: 

— u the user login name, in parentheses, also follows the process ID. 

-k the SIGKILL signal is sent to each process. Since this option 

spawns kills for each process, the kill messages may not show up 
immediately [see kill(2)]. 

If more than one group of files are specified, the options may be respecified 
for each additional group of files. A lone dash cancels the options currently 
in force; then, the new set of options applies to the next group of files. 

The process IDs are printed as a single line on the standard output, 
separated by spaces and terminated with a single new line. All other output 
is written on standard error. 

Any user with permission to read /dev/kmem and /dev/mem can use fuser. 
Only the super-user can terminate another user’s process. 

FILES 

/unix for system namelist 

/dev/kmem for system image 
/dev/mem also for system image 

SEE ALSO 

mount(lM). 

ps(l) in the User’ s Reference Manual. 

kill(2), signal(2) in the Programmer’ s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

fwtmp, wtmpfix - manipulate connect accounting records 
SYNOPSIS 

/usr/lib/acct/fwtmp [— ic] 

/usr/Iib/acct/wtmpfix [files] 

DESCRIPTION 
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FILES 

/etc/wtmp 

/usr/include/utmp.h 

SEE ALSO 

acct(lM), acctcms(lM), 
acctsh(lM), runacct(lM) 

acctcom(l), ed(l) in the User’ s Ref erence Manual 
acct(2), acct(4), utmp(4) in the Programmer’s Reference Manual 

ORIGIN 

AT&T V.3.1 


acctcon(lM), acctmerg(lM), acclprc(lM), 
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NAME 

fx - disk utility 
SYNOPSIS 

fx [ -x ] [ -r retries ] [ -1 logfile ] ["drive_spec" ["drive_type"]] 
DESCRIPTION 

fx is an interactive, menu-driven disk utility. It allows bad blocks on a disk 
to be detected and mapped out. It also allows display of information stored 
on the label of the disk, including partition sizes, disk drive parameters and 
the volume directory. 

An extended mode, available by invoking with the -x flag, provides addi- 
tional functions normally used during factory set-up or servicing of disks, 
such as formatting the disk and creating or modifying the disk label. 
Warning: unless you are very familiar with the parameters and partitions of 
your disks, you are strongly advised not to invoke the extended mode oifx. 
A mistake in extended mode can destroy all the data on the disk. 

The -r retries option allows you to specify how many retries fx will attempt 
when exercising the disk. If you have persistent soft errors, -r 0 will usu- 
ally allow fx to find the bad sectors and spare them. 

The -I logfile option (in the unix command version only) will cause fx to log 
disk errors, blocks that are forwarded, and other severe errors in the given 
file. 

USING FX 

fx exists in both standalone and command versions. A copy of the stan- 
dalone version is normally kept in Istandlfx, and may be invoked when the 
system is not running by means of the standalone shell sash. Note that it is 
necessary to be superuser to use the command version of fx, since it 
accesses the device files for the disks. 

On invocation, fx prompts for a disk controller type, with a default of the 
root disk controller type. Recognised controller types are dksc for SCSI 
drives, dkip for ESDI or SMD drives with Interphase controllers, xyl for 
SMD drives with Xylogics controllers, and fd for floppy drives (command 
version only). 

fx Controller number will normally be 0 unless your system has more than 
one controller and you wish to work on disks attached to the second con- 
troller. Drive number depends on controller type. ESDI and SMD drives are 
numbered from 0 to 1 (or 0 to 3, if the controller can handle 4 drives), with 
drive 0 on controller 0 normally used as the root disk. SCSI drives are 
numbered from 1 to 6, with drive 1 on controller 0 normally used as the root 
disk, fx next prompts for the drive type, with a default of the drive type 
stored in the disk label. 
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The controller type, controller number and drive number as well as drive 
type may be given as command line parameters, bypassing the interactive 
questions just described. The format is: 

fx "controllertype(controller_number, drive_number)" "drive_type" 

for example: 

fx "dkip(0,l)" "Hitachi 512-17" 

The quotes are essential in the first argument since parentheses are shell 
special characters, and in the second because the drive name contains a 
space. For floppy disk drives, you are also prompted for the density to use. 

Once controller type, controller number, drive number and drive type are 
selected, fx performs some sanity checks in regards to partition layout, etc. 
If any ’major’ differences are found, you will be asked whether you want to 
use the existing values. It is almost always correct to keep the existing 
values, unless you are going to initialize the disk anyway. 

fx then enters its main menu. Menu items may be selected either by the 
name or number shown on the menu. A menu item may be an action (e.g 
exit), or the name of a submenu (e.g. badblock). 

Selecting a submenu name will cause that submenu to be displayed, and 
items from it may then be selected. 

To return to a parent menu from a submenu, enter two dots 

To obtain a "help" display giving more information about the items on the 
current menu, enter a question mark ("?") at the prompt. Many of the func- 
tions listed below have options to modify their actions; to obtain informa- 
tion about them, enter "? item" where the item may be either the name or 
the number. 

To exit from fx, select ex it at the main menu. Selecting at the top level 
allows you to select a different disk without having to exit and restart. 

Once the main menu is reached, fx catches interrupts: an interrupt will stop 
any operation in progress but will not terminate fx itself. 

BADBLOCK MANAGEMENT 

Most disks have a number of defective spots where data cannot be stored. 
The disk controller is able to get around this by dynamically replacing a bad 
block with a good block from a pool reserved for this purpose. A list is kept 
on the disk of defects and their replacements. If new bad blocks develop 
during the life of the system, it is necessary to add these new bad blocks to 
the badblock list. Typically, the disk driver will print error messages on the 
console when it encounters a bad block. These error messages will give the 
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location of the bad block, either as a single block number or as cylinder, 
head and sector (in a form such as chs: 123/4/5) depending on the controller 
type. The disk is identified by its special file name: see dkip(7) or dksc(7). 

Note that the SCSI disk driver prints bad block numbers relative to the start 
of the partition it is accessing. In this case, it is therefore necessary to add 
the starting blocknumber of the partition to the blocknumber printed by the 
driver in order to arrive at an absolute blocknumber before adding it as a 
bad block. 

Warning: for EDSI and SMD drives, fx attempts to save data when mapping 
out bad blocks. Data is NOT saved for SCSI disks. In all cases it is strongly 
recommended to make a backup of the disk before proceeding with any 
badblock operations. Badblock mapping is NOT supported for floppy disk 
drives. 

To map out a bad block, invoke fx, select the appropriate disk and go to the 
badblock menu. For SMD or EDSI disks, select the readinbb item to read in 
the existing badblock list from the disk. Next, select the showbb item to 
display the existing badblock list. Typically, there will be a small number of 
entries. If there are no entries, it is possible that the badblock list has been 
lost or corrupted. In this case, for ESDI or SMD drives, you should attempt 
to recover the manufacturer’s original defect list by entering readdefects. 

Note that no corresponding function exists for SCSI drives, and the reade- 
fects menu item does not appear. Also, for SCSI drives it is not necessary to 
read a badblock list before adding new bad blocks. 

To enter new bad blocks, select the addbb item. Then enter the location of 
the bad block (fx accepts either a single blocknumber or a 
cylinder/head/sector specification). More than one badblock can be 
entered; when you have finished entering, terminate the entries by entering 
two dots (".."). For SMD and ESDI disks, the updated badblock list must 
then be saved to to disk and the new bad blocks mapped out. Select the for- 
ward option on the badblock menu to do this. 

For SCSI disks, bad blocks are mapped out as soon as they are entered via 
the addbb function, and nothing more need be done; the forward item does 
not appear on the menu. 

It is also possible to scan the disk surface for bad blocks automatically. To 
do this, select the exercise option on the main fx menu. Select sequential on 
the exercise menu and use the defaults for exercise type and range: this will 
cause a read-only scan of the entire disk surface. Defects detected during 
the scan will be automatically added to the badblock list. Note that all exer- 
cises in the normal (non-extended) mode of fx are read-only for safety; this 
means that some defects may escape detection. Also, the exercise function 
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will mark as bad only unrecoverable blocks: blocks which can be accessed 
but need one or more retries will not be marked as bad since disk drivers 
hide soft errors from user programs. For this reason, it is advisable to keep 
notes of persistent soft error messages (retries) which the disk driver prints 
on the console during normal operations, and add these bad blocks manu- 
ally. It is best to replace a block which is going bad before it becomes 
unreadable. 

FX DISPLAY FUNCTIONS 

fx can display the information in the various parts of the disk label. To do 
this, select the label option at the main menu. Then select the readin func- 
tion, and select the part(s) of the label you wish to display; this will read in 
the information from the disk. Return to the label menu and select show, 
the various parts of the label can then be selected for display. 

FX DEBUG FUNCTIONS 

fx has a menu of disk debug functions. For safety reasons, these are some- 
what restricted in the normal (non-extended) mode. However, a function 
which may be useful is the ability to directly read and display the contents 
of any block on the disk. In the debug menu, select seek. You can then 
enter the blocknumber you wish to read, either as a single blocknumber or 
as a cylinder/head/sector specification. Note that this is an absolute block 
number, starting at the beginning of the disk: if you wish to read the Nth 
block of a given partition you must convert this to an absolute block 
number by adding the starting block of the partition. (Partition information 
may be obtained by the label display function mentioned above). 

Once the block is selected, it can be read by the readbuf item. (This can 
read up to 100 consecutive blocks from the selected starting block). Data 
read from the disk can then be displayed by dumpbuf, it is shown in both 
hex and (if printable) character format. 

MENU DESCRIPTIONS 

The top level fx menu contains the following choices: 

1) exit Exits from fx. If changes have been made to the copy fx keeps of 

the disk label and this has not been written to the disk, a prompt 
will give the option to write it to disk. 

2) badblock 

Selects the menu of operations dealing with bad block handling. 

3) debug 

Selects the menu of debug functions. 

4) exercise 

Selects the menu of functions for analysing the disk surface to find 
bad blocks. 
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5) label Selects the menu of functions for reading (and, in extended mode, 

modifying) the disk label. 

The remaining options appear only in extended mode. 

6) auto A function for initializing a new disk. The disk is formatted, a 

label is created and written to it, and it is exercised in order to 
detect and map out bad blocks. 

1) format 

Formats the disk. With SCSI disks, the whole disk is formatted. 
With ESDI or SMD disks, it is possible to format a range of 
cylinders; prompts are given for start cylinder and number of 
cylinders, the defaults being the entire disk. Note that with SMD 
disks, the defect information placed on the disk by the manufac- 
turer is destroyed by formatting, so when formatting an SMD disk, 
fx automatically attempts to read and save this information first. If 
the disk has been previously formatted, fx will find no defect infor- 
mation on the disk. In this case, it will print a message saying that 
no defect information was found after trying a few tracks, and 
offering the possibility of abandoning the search for it or continu- 
ing. If it is known that an SMD disk has been previously format- 
ted, the reformat will be considerably speeded up by a "no" answer 
to this question. 

8) restore 

This function allows a UNIX file to be copied to a partition of the 
disk. By selecting as source a device special file of a partition on 
another disk, this function allows disks to be cloned. 

BADBLOCK MENU 

Badblocks are handled differently by SCSI and ESDI/SMD controllers. In 
the case of SCSI controllers, the list of badblocks is maintained by the SCSI 
controller/formatter hardware; it can be interrogated and altered but does 
not appear in the user-readable part of the disk. For EDSI/SMD disks, the 
badblock list is a structure maintained explicitly by fx in the SGI-specific 
label area on the disk. EDSI/SMD badblocks are managed on a track basis: 
if a track has one or more bad blocks, the entire track is replaced with one 
from the "track replacement" area reserved on the disk. 

The badblock menu contains the following choices: 

1) addbb 

Allows new bad blocks to be added to the badblock list. Blocks 
may be identified either by a single blocknumber or as 
cylinder/head/sector. To terminate adding bad blocks, enter two 
dots this returns to the badblock menu. In the SCSI case, an 
entered bad block is immediately inserted in the on-disk list 
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maintained by the SCSI controller/formatter. In the ESDI/SMD 
case, it goes into the in-core copy of the badblock list maintained 
by fx, and does not become effective until the forward command 
has been given. 

2) deletebb 

Deletes a block from the badblock list. Essentially this is just to 
allow any mistake made during entry to be corrected; once a block 
has been identified as bad it will remain so. Note that this function 
does not appear for SCSI disks; there is no way to remove an 
added badblock from a SCSI disk without reformatting the whole 
disk. 

3) readdefects 

This function appears in the menu only for ESDI or SMD disk 
types. It reads the defect information placed on the disk by the disk 
manufacturer, and adds bad blocks to the bad block list. (If the 
blocks identified by the manufacturer’s defect information are 
already in the bad block list, nothing is altered). This function is 
useful for retrieving original defect information if the badblock list 
in the disk label has become lost or corrupted for some reason. 
Note that once an SMD disk has been formatted, the 
manufacturer’s defect information is overwritten. 

4) readinbb 

Reads the bad block list in the disk label into memory. (Note that 
fx does not keep an in-core bad block list for SCSI drives, so this 
function appears only for ESDI or SMD drive types). It should be 
used before adding any bad blocks, to ensure that the current bad- 
block list is being worked on. 

5) showbb 

This displays the current badblock list. For ESDI and SMD disks, 
the displayed list is the in-core copy kept by fx, originally read in 
with readinbb and possibly modified with addbb. 

For SCSI disks, it is obtained by interrogating the SCSI controller. 
What is displayed in this case is the physical location of the bad 
sectors; the SCSI controller does not retain a record of the former 
logical blocknumber of a bad block. 

6) forward 

For ESDI and SMD disks, this saves the badblock list to disk, and 
causes the disk controller to map out any newly added bad blocks. 
(It does not appear for SCSI disks since added bad blocks on a 
SCSI disk are effective immediately). 
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The remaining option appears only in extended mode. 

7) createbb 

This clears out any existing badblock list held by fx for the disk. It 
appears of course only for ESDI or SMD disks, and would nor- 
mally be used only when a disk is being completely reformatted. 

DEBUG MENU 

This gives access to miscellaneous debug functions, mostly for reading and 
writing disk blocks. An internal memory buffer is provided as a source or 
destination for data; the contents of this buffer may be displayed and edited. 
In the normal (non-extended) mode of fx, only nondestructive functions are 
available. In the extended mode, disk blocks may be written as well as read. 
Options are: 

1) cmpbuf 

This allows blocks of data in different areas of the buffer to be 
compared, for example, to compare written and read-back data. It 
prompts for the starts of the two areas to be compared (relative to 
the beginning of the internal buffer), and for the length of com- 
parison. 

2) dumpbuf 

This allows display of the contents of the buffer. It prompts for 
start address (relative to beginning of buffer), length to display and 
display format: bytes, (2-byte) words, or (4-byte) longwords. Data 
is displayed in the hex format selected, and also in character for- 
mat with non-printable characters represented by dots. 

3) editbuf 

Allows individual buffer locations to be modified in byte, 2-byte or 
4-byte units. 

4 )fillbuf 

Allows sections of the buffer to be filled with a repeating pattern. 
It prompts for start location and length to fill, and for a string of 
data to use as the fill pattern. (Unfortunately only a string is 
accepted, it is not possible to enter hex data. The buffer may be 
cleared by entering a null string). 

5) number 

Accepts a decimal number, and prints it in octal and hex. For ESDI 
and SMD drive types only, it also prints the input, interpreted as a 
blocknumber, in the form cylinder/head/sector for the current 
drive. It will also accept input in the form cylinder/head/sector (eg 
123/4/5) and print the corresponding blocknumber. (SCSI drives 
are always accessed by a single blocknumber, so this translation is 
not performed if the current drive type is SCSI). 
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6) readbuf 

This allows disk blocks to be read into the internal buffer. It 
prompts for buffer address (relative to start of buffer), and number 
of blocks to read. Up to 100 blocks may be read in one operation. 
The disk block address from which the read will occur is main- 
tained as an internal variable by fx, it can be set with the seek func- 
tion. 

7) seek This sets the internal fx variable which holds the source or destina- 

tion blocknumber on disk for transfers between disk and the inter- 
nal buffer. A prompt of the current value is given. 

The remaining functions appear only in extended mode, since they are 
either potentially destructive (eg writebuf) or of little interest to the normal 
user. 

8) writebuf 

This writes blocks from the internal buffer to the disk. It prompts 
for source buffer address and number of blocks to write. The disk 
address block for the write is taken from the internal fx variable set 
by seek, as for readbuf. 

9) showuib 

This function appears only for ESDI or SMD drives. It prints the 
Unit Initialisation parameters used by the disk controller for the 
current drive. 

10) shows tat us 

This function appears only for ESDI or SMD drives. It prints the 
firmware ID code of the Disk controller, and the status of the con- 
troller and drive. 

11) rawreadbuf 

This function appears only for ESDI or SMD drives. It is some- 
thing of a misnomer, since what it actually does is to invoke the 
disk controller command intended for reading ESDI or SMD 
manufacturer’s flawmaps at the start of tracks. It prompts for desti- 
nation buffer address, disk address and length. It should be noted 
that the sector part of disk address is irrelevent, since the controller 
always reads at start of track for this function. Also, the length 
parameter is ignored! The controller always transfers one sector 
for this operation. 

12) rawreadcdc 

This function appears only for Interphase controllers. It is a vari- 
ant of the previous function, invoking a flawmap read function of 
the Interphase controller intended to compensate for the different 
format of flawmaps on CDC disks. 
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13) passthru 

This appears only because the runtime fx utility shares common 
code with the standalone version. Direct passthrough of drive com- 
mand codes is not allowed at runtime. 

EXERCISE MENU 

This gives access to functions intended for surface analysis of the disk to 
find bad blocks. Only read-only tests are possible in normal (non-extended) 
mode; destructive read-write tests are allowed in extended mode. 

1) butterfly 

Invokes a test pattern in which successive transfers cause seeks to 
widely separated areas of the disk. This is intended to stress the 
head positioning system of the drive, and will sometimes find 
errors which do not show up in a sequential test. It prompts for the 
range of disk blocks to exercise, number of scans to do, and a test 
modifier. Each of the available test patterns may be executed in a 
number of different modes (read-only, read-write etc) which will 
be described below. 

2) errlog 

This prints the total number of read and write errors which have 
been detected during a preceding exercise. 

3) random 

Invokes a test pattern in which the disk location of successive 
transfers is selected randomly; intended to simulate a multiuser 
load. As with the butterfly test, it prompts for range of blocks to 
exercise, number of scans, and modifier. 

4) sequential 

Invokes a test pattern in which the disk surface is scanned sequen- 
tially. As with the butterfly test, it prompts for range of blocks to 
exercise, number of scans, and modifier. 

The following items appear only in extended mode, since they are con- 
cerned with destructive (write) tests. 

5) settestpat 

This allows the pattern of data which will be used in tests which 
write to the disk to be created. One sector of data may be initial- 
ised, byte by byte. Each byte may be entered as a decimal or hex 
value. 

6) showtestpat 

This displays the pattern of data which will be used in tests which 
write to the disk. The default is a repeating pattern of Oxdb 0x6d 
0xb6. This may be changed with settestpat. 
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7) complete 

This causes a write-and-compare sequential test to be run on the 
entire disk area. 

The butterfly, random and sequential tests prompt for a modifier which 
determines the type of transfer which will occur during the test patterns. 
Possible modifiers are: 

rd-only This causes a read of one track of the disk at each location in the 
test pattern. The value of read data is ignored, the test detects only 
the success or failure of the read operation. 

rd-cmp This causes two reads of the disk track at each location in the test 
pattern. The data obtained in the two reads is compared. 

seek With this modifier, only one sector is read at each step of the test 
pattern: this simply confirms that the issued seek was executed 
correctly, without checking readability of a complete track. 

The following modifiers are presented and legal only in extended mode, 
since they cause writing to the disk, thereby destroying existing data. 

wr-only This causes data to be written to one track of the disk at each loca- 
tion in the test pattern. Written data is not re-examined, the test 
detects only the success or failure of the write operation. 

wr-cmp This causes data to be written to one track of the disk at each loca- 
tion in the test pattern. The written data is then read back and com- 
pared with its expected value. 

LABEL MENU 

This gives access to functions for displaying, and (in extended mode) modi- 
fying information contained in the disk label. It contains the following 
items: 

1) readin 

Allows part or all of the label to be read in from the disk. Selecting 
this item brings up a menu of the accessable parts of the label. 
(These are described in detail below). Selecting a part causes that 
part to be read in from disk; there is also an all option, to read in 
all parts at once. 

2) show Allows display of parts of the label. As for readin, it brings up a 

menu of the label parts, allowing selection of the part to be 
displayed. 

The remaining items appear only in extended mode, since they offer the 
possibility of changing data on the disk. 

3) sync Writes the in-core copy of the disk label back to disk. 
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4) set Allows parts of the label to be modified. As for readin, it brings 

up a menu of the label parts, allowing selection of the part to be 
modified. 

5) create 

Discards existing label information, and creates new label informa- 
tion. If the label on disk is valid, the created label information is 
based on this, otherwise default label information based on the 
drive type is created. This would normally be used only for 
attempting to repair a damaged disk label (or to recover from 
major errors during set). As for readin , it brings up a menu of the 
label parts, allowing selection of the part to be worked on. 

Parts of the disk label 

A disk label contains the following parts: 

1) parameters 

This is information used by the disk controller, such as disk 
geometry (eg number of cylinders), and format information (eg 
interleave). It may be viewed under the show submenu of the label 
menu, and in extended mode may be changed by the set submenu 
or reset to default values for the drive type by the create submenu. 
The parameters concerned will depend on the type of controller. 
These values will not need to be changed in normal use; a full dis- 
cussion is beyond the scope of this document and the reader should 
refer to the manufacturer’s documentation for the disk controller 
and disk drive. 

2) partitions 

The disk surface is divided for convenience into a number of dif- 
ferent sections ("partitions") used for various purposes. (See intro 
(7m) for more details). When the operating system is accessing the 
disk, its drivers make the connection between the special file name 
and the physical disk partition using information from the partition 
table in the disk label. This information may be displayed under 
the show submenu of the label menu, and in extended mode 
changed under the set submenu or reset to default values for the 
drive type by the create submenu. There may be up to 16 partitions 
on a disk, numbered 0 to 15 (though not all need be present). Each 
partition is described by its starting block on the disk, its size in 
blocks, and a type indicating its expected use (eg filesystem, disk 
label, swap etc). 

3) sgiinfo 

This contains information kept for administrative purposes: the 
type of disk drive and its serial number. As with other parts of the 
label, it may be viewed under the show submenu of the label 
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menu, and in extended mode may be changed by the set submenu 
or reset to default values for the drive type by the submenu. 

4) bootinfo 

This contains information used by the system proms during a nor- 
mal system boot. It specifies the root partition, the name of the file 
on the root partition to boot, and the swap partition. Normal 
defaults for these are root partition 0, filename /unix and swap par- 
tition 1. Current setting may be viewed under the show submenu of 
the label menu, and in extended mode changed under the set sub- 
menu. The defaults appear as prompts, and may be changed by 
inputting different values. 

5) directory 

Some system files are normally kept in the label area on the disk. 
These are files used in standalone operations such as the stan- 
dalone shell sash and the standalone version of fx. The directory is 
a table in the label which enables these files to be located. The 
show submenu of the label menu allows the directory of these files 
to be displayed. 

The files in the disk label are manipulated by the use of dvhtool 
(lm) and fx does not provide facilities for adding or deleting them. 

INITIALIZING NEW DISKS 

fx may be used to initialize disk drives which have not been previously for- 
matted. 

The new drive to be initialized should be physically connected to the sys- 
tem. 

Warning: this should not be attempted on a disk that is in use! 

Take care that termination of the new drive is correct and that its drive id 
does not conflict with that of any other drive connected to the same con- 
troller. With the new drive connected, bring the system back up to normal 
multiuser mode, and invoke fx in extended mode. Enter the controller type 
and number, and the drive number for the new drive. For SCSI drives, the 
drive type will be determined automatically by an inquiry operation on the 
drive. For ESDI or SMD drives, a menu of known drive types will appear; it 
is important to know the exact model number of the drive you are adding. 
(Note that it is possible to work with drives other than those on the menu by 
entering a drive name of "other", and then entering parameters for the drive. 
This is intended only for engineering tests and evaluations. Use of drives 
not qualified by Silicon Graphics Inc is not recommended). 

Once drive type is identified, select the auto item on the main menu; this 
will format the drive, scan it for bad blocks, and place a label on it. On 
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completion of this, exit from fx; the drive is now ready for use. 

Note that for the new drive to be useful in the system, it will be necessary to 
make filesystems on it and to mount these filesystems. See mkfs (1M) and 
mount (1M) 

FILES 

/dev/rdsk/ips*, /dev/rdsk/dks*, /dev/rdsk/fds* 

SEE ALSO 

dvhtool( 1M), dkip( 7), dksc(l), smfd(7), vh( 1) 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

getty - set terminal type, modes, speed, and line discipline 
SYNOPSIS 

/etc/getty [ -h ] [ -t timeout ] line [ speed [ type [ linedisc ] ] ] 
/etc/getty -c file 

DESCRIPTION 

getty is a program that is invoked by /nfi(lM). It is the second process in 
the series, ( init-getty-login-shell ) that ultimately connects a user with the 
UNIX system. It can only be executed by the super-user; that is, a process 
with the user-ID of root. Initially getty prints the login message field for 
the entry it is using from /etc/gettydefs. getty reads the user’s login name 
and invokes the login{ 1) command with the user’s name as argument. 
While reading the name, getty attempts to adapt the system to the speed and 
type of terminal being used. It does this by using the options and arguments 
specified. 

Line is the name of a tty line in /dev to which getty is to attach itself, getty 
uses this string as the name of a file in the /dev directory to open for reading 
and writing. Unless getty is invoked with the -h flag, getty will force a 
hangup on the line by setting the speed to zero before setting the speed to 
the default or specified speed. The -t flag plus timeout (in seconds), 
specifies that getty should exit if the open on the line succeeds and no one 
types anything in the specified number of seconds. 

Speed , the optional second argument, is a label to a speed and tty definition 
in the file /etc/gettydefs. This definition tells getty at what speed to initially 
run, what the login message should look like, what the initial tty settings 
are, and what speed to try next should the user indicate that the speed is 
inappropriate (by typing a <break> character). The default speed is 300 
baud. 


Type , the optional third argument, is a character string describing to getty 
what type of terminal is connected to the line in question, getty recognizes 
the following types: 


none 

ds40-l 

tektronix,tek 

vt61 

vtlOO 

hp45 

clOO 


default 

Dataspeed40/1 
Tektronix 
DEC vt61 
DEC vtlOO 
Hewlett-Packard 45 
Concept 100 


The default terminal is none; i.e., any crt or normal terminal unknown to 
the system. Also, for terminal type to have any meaning, the virtual termi- 
nal handlers must be compiled into the operating system. They are 
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available, but not compiled in the default condition. 

Linedisc, the optional fourth argument, is a character string describing 
which line discipline to use in communicating with the terminal. There are 
two line disciplines. LDISCO is the familiar System V line discipline. 
LDISC1 is similar to the 4.3BSD “new tty driver” (see termio(l)). 

When given no optional arguments, getty sets the speed of the interface to 
300 baud, specifies that raw mode is to be used (awaken on every charac- 
ter), that echo is to be suppressed, either parity allowed, new-line characters 
will be converted to carriage return-line feed, and tab expansion performed 
on the standard output. It types the login message before reading the user’s 
name a character at a time. If a null character (or framing error) is 
received, it is assumed to be the result of the user pushing the “break” key. 
This will cause getty to attempt the next speed in the series. The series that 
getty tries is determined by what it finds in /etc/gettydefs. 

After the user’s name has been typed in, it is terminated by a new-line or 
carriage-return character. The latter results in the system being set to treat 
carriage returns appropriately (see ioctl( 2)). 

The user’s name is scanned to see if it contains any lower-case alphabetic 
characters; if not, and if the name is non-empty, the system is told to map 
any future upper-case characters into the corresponding lower-case charac- 
ters. 

Finally, login is exec’d with the user’s name as an argument. Additional 
arguments may be typed after the login name. These are passed to login, 
which will place them in the environment (see login(l)). 

If getty is running on the graphics console, getty checks to see if autologin 
is enabled by verifying the existence of /etc/autologin and /etc/autologin. on 
(see login(l)). If autologin is enabled, getty will invoke login with the auto- 
login option. 

A check option is provided. When getty is invoked with the -c option and 
file, it scans the file as if it were scanning /etc/gettydefs and prints out the 
results to the standard output. If there are any unrecognized modes or 
improperly constructed entries, it reports these. If the entries are correct, it 
prints out the values of the various flags. See ioctl( 2) to interpret the 
values. Note that some values are added to the flags automatically. 

FILES 

/etc/gettydefs 

/etc/issue 

/etc/autologin 

SEE ALSO 

ct(lC), init(lM), tty(7). 
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login(l) in the U ser' s Reference Manual. 

ioctl(2), gettydefs(4), inittab(4) in the Programmer’ s Reference Manual. 

BUGS 

While getty understands simple single character quoting conventions, it is 
not possible to quote certain special control characters used by getty. Thus, 
you cannot login via getty and type a #, @, /, !, _, backspace, "U, “D, or & 
as part of your login name or arguments, getty uses them to determine 
when the end of the line has been reached, which protocol is being used, 
and what the erase character is. They will always be interpreted as having 
their special meaning. 

ORIGIN 

AT&T V.3 
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NAME 

halt - halt the system 

SYNOPSIS 

cd /; /etc/halt 

DESCRIPTION 

When UNIX is running halt halts and then leaves it executing the PROM 
monitor. It is used to stop the system before turning it off. 

SEE ALSO 

reboot(lM), kill(2), shutdown(lM), brc(lM) fsck(lM), init(lM), sync(lM). 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

hinv - hardware inventory command 

SYNOPSIS 

hinv [-v] 

DESCRIPTION 

hinv displays the contents of the system hardware inventory table. This 
table is created each time the system is booted and contains entries describ- 
ing various pieces of hardware in the system. The items in the table include 
main memory size, cache sizes, floating point unit, and disk drives. 
Without arguments, the hinv command will display a one line description of 
each entry in the table. The -v flag will give a more verbose description of 
some items in the table. 

SEE ALSO 

getinvent(3) in the Programmer' s Reference Manual. 

BUGS 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

hyroute - set the HyperNet routing tables 
SYNOPSIS 

hyroute [ -s ] [ -p ] [ -c ] [ -d ] [ file ] 

DESCRIPTION 

Hyroute manipulates the HYPERchannel(TM) routing information. 

With the -s option, it reads file and sets the system’s database according to 
the information in the file (see below). The input file defaults to 
/usr/etc/hyroute.conf if one is not specified. If the argument is encoun- 
tered, hyroute reads from standard input. 

The -c option causes hyroute to compare the system’s current information 
to that contained in file. 

The -p option causes a digested version of file to be printed. 

The -d option causes a "dump" of the system’s table (used for debugging 
routing code). 

FILE FORMAT 

The input file is free format. Comment lines start with a in column one. 
Statements end with a semicolon. 

direct host dest control access ; 

Describes a host that can be directly reached from this adapter. Host is a 
host name as listed in the hosts ( 4) file, dest, control , and access are hexa- 
decimal numbers. The data will be sent to HYPERchannel address dest 
using a control value of control and an access code of access (see the 
adapter manuals for details). 

The specified remote adapter and the local adapter must both be connected 
to one or more common trunks or connected to trunks that are connected 
with with link adapters. 

gateway host gatel gate2 gate3 

Describes a host that must be reached indirectly through any one of the 
gateways indicated on the line. The hosts listed are not gateways in the for- 
mal sense (they don’t run the DARPA Internet gateway protocols), but are 
hosts on the HYPERchannel that can "bridge" between subsections of the 
HYPERchannel network. 


EXAMPLE 


* Sample /usr/etc/hyroute.conf. 

* 

direct sequoia-hy 2200 1100 0; 

direct lassen-hy 6104 1100 0; 
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direct yosemite-hy 2302 1100 0; 

direct glacier-hy 4201 1100 0; 

gateway redwood-hy lassen-hy yosemite-hy glacier-hy 

SEE ALSO 

hy(7), hosts(4) 

FILES 

/dev/hy* Character special file to get to the interface (only has an 

ioctl entry) 

/usr/etc/hyroute.conf 

NOTE 

HYPERchannel is a registered trademark of Network Systems Corp. 

AUTHOR 

Steve Glaser 

ORIGIN 

Tektronix, as modified by Silicon Graphics, Inc. 
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NAME 

id - print user and group IDs and names 

SYNOPSIS 

id 

DESCRIPTION 

id outputs the user and group IDs and the corresponding names of the 
invoking process. If the effective and real IDs are different, both are 
printed. 

FILES 

/usr/bin/id 
SEE ALSO 

logname(l) in the User’ s Reference Manual. 
getuid(2) in the Programmer' s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

ifconfig - configure network interface parameters 
SYOPNSIS 

/usr/etc/ifconfig interface address_family [ address [ dest address ] ] [ 
parameters ] 

/usr/etc/ifconfig interface [ protocol_family ] 

DESCRIPTION 

Ifconfig is used to assign an address to a network interface and/or configure 
network interface parameters. Ifconfig must be used at boot time to define 
the network address of each interface present on a machine; it may also be 
used at a later time to redefine an interface’s address or other operating 
parameters. The interface parameter is a string of the form “name unit”, 
e.g., “enpO”. 

Since an interface may receive transmissions in differing protocols, each of 
which may require separate naming schemes, it is necessary to specify the 
address Jamily, which may change the interpretation of the remaining 
parameters. Currently, just the “inet” address family is supported. 

For the DARPA Internet family, the address is either a host name present in 
the host name data base, hostsIA), or a DARPA Internet address expressed 
in the Internet standard “dot notation”. 

The following parameters may be set with ifconfig : 

up Mark an interface “up”. This may be used to enable an 

interface after an “ifconfig down.” It happens automati- 
cally when setting the first address on an interface. If the 
interface was reset when previously marked down, the 
hardware will be re-initialized. 

Mark an interface “down”. When an interface is 
marked “down”, the system will not attempt to transmit 
messages through that interface. If possible, the interface 
will be reset to disable reception as well. This action 
does not automatically disable routes using the interface. 

Enable the use of the Address Resolution Protocol in 
mapping between network level addresses and link level 
addresses (default). This is currently implemented for 
mapping between DARPA Internet addresses and 
lOMb/s Ethernet addresses. 

Disable the use of the Address Resolution Protocol. 

Set the routing metric of the interface to n, default 0. 
The routing metric is used by the routing protocol 
(routed( lm)). Higher metrics have the effect of making 
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netmask mask 


broadcast 


trailers 


-trailers 

dstaddr 

debug 

-debug 


a route less favorable; metrics are counted as addition 
hops to the destination network or host. 

Specify how much of the address to reserve for subdivid- 
ing networks into sub-networks. The mask includes the 
network part of the local address and the subnet part, 
which is taken from the host field of the address. The 
mask can be specified as a single hexadecimal number 
with a leading Ox, with a dot-notation Internet address, or 
with a pseudo-network name listed in the network table 
networksifi). The mask contains l’s for the bit positions 
in the 32-bit address which are to be used for the network 
and subnet parts, and 0’s for the host part. The mask 
should contain at least the standard network portion, and 
the subnet field should be contiguous with the network 
portion. 

Specify the address to use to represent broadcasts to the 
network. The default broadcast address is the address 
with a host part of all l’s. 

Request the use of a “trailer” link level encapsulation 
when sending. If a network interface supports trailers, 
the system will, when possible, encapsulate outgoing 
messages in a manner which minimizes the number of 
memory to memory copy operations performed by the 
receiver. On networks that support the Address Resolu- 
tion Protocol (see arp(7P); currently, only 10 Mb/s Eth- 
ernet), this flag indicates that the system should request 
that other systems use trailers when sending to this host. 
Similarly, trailer encapsulations will be sent to other 
hosts that have made such requests. 

Disable the use of a “trailer” link level encapsulation 
(default). 

Specify the address of the correspondent on the other end 
of a point to point link. 

Enable driver-dependent debugging code; usually, this 
turns on extra console error logging. 

Disable driver-dependent debugging code. 


Ifconfig displays the current configuration for a network interface when no 
optional parameters are supplied. If a protocol family is specified, ifconfig 
will report only the details specific to that protocol family. 
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Only the super-user may modify the configuration of a network interface. 
DIAGNOSTICS 

Messages indicating the specified interface does not exit, the requested 
address is unknown, or the user is not privileged and tried to alter an 
interface’s configuration. 

SEE ALSO 

netstat(l), rcO(lM), rc2(lM) 

ORIGIN 

4.3BSD 
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NAME 

inetd - Internet ‘ ‘super-server’ ’ 

SYNOPSIS 

/usr/etc/inetd [ -d ] [ configuration file ] 

DESCRIPTION 

Inetd should be run at boot time by / etc linit.dl network. It then listens for 
connections on certain internet sockets. When a connection is found on one 
of its sockets, it decides what service the socket corresponds to, and invokes 
a program to service the request. After the program is finished, it continues 
to listen on the socket (except in some cases which will be described 
below). Essentially, inetd allows running one daemon to invoke several 
others, reducing load on the system. 

Upon execution, inetd reads its configuration information from a 
configuration file which, by default, is lusr/etc/inetd.conf. There must be an 
entry for each field of the configuration file, with entries for each field 
separated by a tab or a space. Comments are denoted by a “#” at the 
beginning of a line. There must be an entry for each field. The fields of the 
configuration file are as follows: 
service name 
socket type 
protocol 
wait/nowait 
user 

server program 

server program arguments 

The service name entry is the name of a valid service in the file 
I etc! services (see services^ 4)). For “internal” services (discussed below), 
the service name must be the official name of the service (that is, the first 
entry in /etc /services). For RPC services, the value of service name field 
consists of the RPC service name, followed by a slash and either a version 
number or a range of version numbers (e.g., mountd/1). 

The socket type should be one of “stream”, “dgram”, or “raw”, depend- 
ing on whether the socket is a stream, datagram, or raw socket. 

The protocol must be a valid protocol as given in / etc! protocols (see proto- 
cols (4)). Examples might be “top” or “udp”. For RPC services, the field 
consists of the string rpc followed by a slash and the name of the protocol 
(e.g., rpc/udp for an RPC service using the UDP protocol as a transport 
mechanism). 

The waitlnowait entry is applicable to datagram sockets only (other sockets 
should have a “nowait” entry in this space). If a datagram server connects 
to its peer, freeing the socket so inetd can received further messages on the 
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socket, it is said to be a “multi-threaded” server, and should use the 
“nowait” entry. For datagram servers which process all incoming 
datagrams on a socket and eventually time out, the server is said to be 
“single-threaded” and should use a “wait” entry. Datagram servers that 
establishes pseudo-connections must be listed as “wait” in order to avoid a 
race; e.g., the tftpd server reads the first packet, creates a new socket, and 
then forks and exits to allow inetd to check for new service requests to 
spawn new servers. 

The user entry should contain the user name of the user as whom the server 
should run. This allows for servers to be given less permission than root. 
The server program entry should contain the pathname of the program 
which is to be executed by inetd when a request is found on its socket. If 
inetd provides this service internally, this entry should be “internal”. 

The arguments to the server program should be just as they normally are, 
starting with argvfO], which is the name of the program. If the service is 
provided internally, the word “internal” should take the place of this entry. 

Inetd provides several “trivial” services internally by use of routines 
within itself. These services are “echo”, “discard”, “chargen” (character 
generator), “daytime” (human readable time), and “time” (machine read- 
able time, in the form of the number of seconds since midnight, January 1, 
1900). All of these services are TCP-based. For details of these services, 
consult RFCs 862, 863, 864, 867, and 868. 

Inetd rereads its configuration file when it receives a hangup signal, 
SIGHUP. Services may be added, deleted or modified when the 
configuration file is reread. 

SEE ALSO 

ftpd(lM), rexecd(lM), rlogind(lM), rshd(lM), telnetd(lM), tftpd(lM) 

RFCs are available from the Network Information Center at SRI Interna- 
tional, Menlo Park, CA. 

ORIGIN 

4.3BSD 


Version 3.0 


- 2 - 


September 1988 



INFOCMP(IM) 


Silicon Graphics 


INFOCMP(IM) 


NAME 

infocmp - compare or print out terminfo descriptions 
SYNOPSIS 

infocmp [-d] [— c] [-n] [-1] [-L] [-C] [-r] [-u] [-s d|i|l|c] [-v] [-V] 
[-1] [-w width] [—A directory] [-B directory] [termname ...] 

DESCRIPTION 

infocmp can be used to compare a binary terminfo (4) entry with other ter- 
minfo entries, rewrite a terminfo (4) description to take advantage of the 
use= terminfo field, or print out a terminfo (4) description from the binary 
file (term( 4)) in a variety of formats. In all cases, the boolean fields will be 
printed first, followed by the numeric fields, followed by the string fields. 

Default Options 

If no options are specified and zero or one termnames are specified, the -I 
option will be assumed. If more than one termname is specified, the -d 
option will be assumed. 

Comparison Options [-d] [-c] [ — n] 

infocmp compares the terminfo (A) description of the first terminal termname 
with each of the descriptions given by the entries for the other terminal’s 
termnames. If a capability is defined for only one of the terminals, the 
value returned will depend on the type of the capability: F for boolean vari- 
ables, -1 for integer variables, and NULL for string variables. 

-d produce a list of each capability that is different. In this manner, 
if one has two entries for the same terminal or similar terminals, 
using infocmp will show what is different between the two 
entries. This is sometimes necessary when more than one person 
produces an entry for the same terminal and one wants to see 
what is different between the two. 

-c produce a list of each capability that is common between the two 
entries. Capabilities that are not set are ignored. This option can 
be used as a quick check to see if the -u option is worth using. 

-n produce a list of each capability that is in neither entry. If no 
termnames are given, the environment variable TERM will be 
used for both of the termnames. This can be used as a quick 
check to see if anything was left out of the description. 

Source Listing Options [-1] [-L] [-C] [— r] 

The -I, -L, and -C options will produce a source listing for each terminal 
named. 

-I use the terminfo{A) names 
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-L use the long C variable name listed in <term.h> 

-C use the termcap names 

— r when using -C, put out all capabilities in termcap form 

If no termnames are given, the environment variable TERM will be used for 
the terminal name. 

The source produced by the -C option may be used directly as a termcap 
entry, but not all of the parameterized strings may be changed to the 
termcap format, infocmp will attempt to convert most of the parameterized 
information, but that which it doesn’t will be plainly marked in the output 
and commented out. These should be edited by hand. 

All padding information for strings will be collected together and placed at 
the beginning of the string where termcap expects it. Mandatory padding 
(padding information with a trailing ’/’) will become optional. 

All termcap variables no longer supported by terminfo( 4), but which are 
derivable from other terminfo( 4) variables, will be output. Not all ter- 
minfo(4) capabilities will be translated; only those variables which were 
part of termcap will normally be output. Specifying the -r option will take 
off this restriction, allowing all capabilities to be output in termcap form. 

Note that because padding is collected to the beginning of the capability, 
not all capabilities are output, mandatory padding is not supported, and 
termcap strings were not as flexible, it is not always possible to convert a 
terminfo( 4) string capability into an equivalent termcap format. Not all of 
these strings will be able to be converted. A subsequent conversion of the 
termcap file back into terminfo( 4) format will not necessarily reproduce the 
original terminfo( 4) source. 

Some common terminfo parameter sequences, their termcap equivalents, 
and some terminal types which commonly have such sequences, are: 


Terminfo 

Termcap 

Representative Terminals 

%pl%c 

%. 

adm 

%pl%d 

%d 

hp, ANSI standard, vtlOO 

%pl%’x’%+%c 

%+x 

concept 

%i 

%i 

ANSI standard, vtlOO 

%pl%?%’x’%>%t%pl%’y’%+%; 

%>xy 

concept 

%p2 is printed before %pl 

%r 

hp 


Use= Option [— u] 

-u produce a terminfo (4) source description of the first terminal 
termname which is relative to the sum of the descriptions given 
by the entries for the other terminals termnames. It does this by 
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analyzing the differences between the first termname and the 
other termnames and producing a description with use= fields for 
the other terminals. In this manner, it is possible to retrofit gen- 
eric terminfo entries into a terminal’s description. Or, if two 
similar terminals exist, but were coded at different times or by 
different people so that each description is a full description, 
using infocmp will show what can be done to change one descrip- 
tion to be relative to the other. 

A capability will get printed with an at-sign (@) if it no longer exists in the 
first termname , but one of the other termname entries contains a value for 
it. A capability’s value gets printed if the value in the first termname is not 
found in any of the other termname entries, or if the first of the other term- 
name entries that has this capability gives a different value for the capabil- 
ity than that in the first termname . 

The order of the other termname entries is significant. Since the terminfo 
compiler tic(lM) does a left-to-right scan of the capabilities, specifying two 
use= entries that contain differing entries for the same capabilities will pro- 
duce different results depending on the order that the entries are given in. 
infocmp will flag any such inconsistencies between the other termname 
entries as they are found. 

Alternatively, specifying a capability after a use= entry that contains that 
capability will cause the second specification to be ignored. Using infocmp 
to recreate a description can be a useful check to make sure that everything 
was specified correctly in the original source description. 

Another error that does not cause incorrect compiled files, but will slow 
down the compilation time, is specifying extra use= fields that are 
superfluous, infocmp will flag any other termname use= fields that were not 
needed. 

Other Options [-sdlilllc] [-v] [-V] [-1] [-w width] 

-s sort the fields within each type according to the argument below: 

d leave fields in the order that they are stored in the terminfo 
database. 

i sort by terminfo name. 

1 sort by the long C variable name, 
c sort by the termcap name. 

If no -s option is given, the fields printed out will be sorted alpha- 
betically by the terminfo name within each type, except in the 
case of the -C or the -L options, which cause the sorting to be 
done by the termcap name or the long C variable name, respec- 
tively. 
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-v print out tracing information on standard error as the program 
runs. 

-V print out the version of the program in use on standard error and 
exit. 

—1 cause the fields to printed out one to a line. Otherwise, the fields 
will be printed several to a line to a maximum width of 60 charac- 
ters. 

-w change the output to width characters. 

Changing Databases [-A directory] [-B directory] 

The location of the compiled terminfo( 4) database is taken from the 
environment variable TERMINFO. If the variable is not defined, or the ter- 
minal is not found in that location, the system terminfo( 4) database, usually 
in /usr/lib/terminfo , will be used. The options -A and -B may be used to 
override this location. The -A option will set TERMINFO for the first 
termname and the -B option will set TERMINFO for the other termnames. 
With this, it is possible to compare descriptions for a terminal with the same 
name located in two different databases. This is useful for comparing 
descriptions for the same terminal created by different people. Otherwise 
the terminals would have to be named differently in the terminfo{A) data- 
base for a comparison to be made. 

FILES 

/usr/lib/terminfo/?/* compiled terminal description database 

DIAGNOSTICS 

malloc is out of space! 

There was not enough memory available to process all the 
terminal descriptions requested. Run infocmp several 
times, each time including a subset of the desired term- 
names. 

use= order dependency found: 

A value specified in one relative terminal specification 
was different from that in another relative terminal 
specification. 

’us e=term' did not add anything to the description. 

A relative terminal name did not contribute anything to 
the final description. 

must have at least two terminal names for a comparison to be done. 

The -u, -d and -c options require at least two terminal 
names. 
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SEE ALSO 

tic(lM), curses(3X), term(4), terminfo(4) in the Programmer' s Reference 
Manual. 

captoinfo(lM) in the System Administrator’ s Reference Manual. 

Chapter 10 of the Programmer’ s Guide. 

NOTE 

The termcap database (from earlier releases of UNIX System V) may not be 
supplied in future releases. 

ORIGIN 

AT&T V.3 
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NAME 

init, telinit - process control initialization 
SYNOPSIS 

/etc/init [0123456SsQq] 

/etc/telinit [0123456sSQqabc] 

DESCRIPTION 

Init 

init is a general process spawner. Its primary role is to create processes 
from information stored in the file /etc/inittab (see inittab(4)). This file 
usually has init spawn getty's on each line that a user may log in on. It also 
controls autonomous processes required by any particular system. 

init considers the system to be in a run-level at any given time. A run-level 
can be viewed as a software configuration of the system where each 
configuration allows only a selected group of processes to exist. The 
processes spawned by init for each of these run-levels is defined in the init- 
tab file, init can be in one of eight run-levels, 0-6 and S or s. The run-level 
is changed by having a privileged user run /etc/init. This user-spawned init 
sends appropriate signals to the original init spawned by the operating sys- 
tem when the system was rebooted, telling it which run-level to change to. 

init is invoked inside the UNIX system as the last step in the boot procedure. 
First init looks in /etc/inittab for the initdefault entry (see inittab( 4)). If 
there is one, init uses the run-level specified in that entry as the initial run- 
level to enter. If this entry is not in letc/inittab, init requests that the user 
enter a run-level from the virtual system console, /dev/console. If an S or an 
s is entered, init goes into the SINGLE USER state. This is the only run-level 
that doesn’t require the existence of a properly formatted letc/inittab file. If 
it doesn’t exist, then by default the only legal run-level that init can enter is 
the SINGLE USER state. In the SINGLE USER state the virtual console ter- 
minal /dev/console is opened for reading and writing and the command 
/bin/su is invoked immediately. To exit from the SINGLE USER state, use 
either init or telinit, to signal init to change the run-level of the system. 
Note that if the shell is terminated (via an end-of-file), init will only re- 
initialize to the SINGLE USER state. 

When attempting to boot the system, failure of init to prompt for a new 
run-level may be due to the fact that the device /dev/console is linked to a 
device other than the physical system console (/dev/contty). If this occurs, 
init can be forced to relink /dev/console by typing a delete on the system 
console which is colocated with the processor. 

When init prompts for the new run-level, the operator may enter only one of 
the digits 0 through 6 or the letters S or s. If S or s is entered, init operates 
as previously described in the SINGLE USER state with the additional result 
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that /dev/console is linked to the user’s terminal line, thus making it the vir- 
tual system console. A message is generated on the physical console, 
/dev/contty, saying where the virtual terminal has been relocated. 

When init comes up initially and whenever it switches out of SINGLE USER 
state to normal run states, it sets the ioctl( 2) states of the virtual console, 
/dev/console, to those modes saved in the file /etc/ioctl.syscon. This file is 
written by init whenever the SINGLE USER state is entered. 

If a 0 through 6 is entered init enters the corresponding run-level. Any 
other input will be rejected and the user will be re-prompted. 

If this is the first time init has entered a run-level other than SINGLE USER, 
init first scans inittab for special entries of the type boot and bootwait. 
These entries are performed, providing the run-level entered matches that of 
the entry before any normal processing of inittab takes place. In this way 
any special initialization of the operating system, such as mounting file sys- 
tems, can take place before users are allowed onto the system. The inittab 
file is scanned to find all entries that are to be processed for that run-level. 

Run-level 2 is defined to contain all of the terminal processes and daemons 
that are spawned in the multi-user environment. Hence, it is commonly 
referred to as the MULTI-USER state. Run-levels 3 and 4 are available to be 
defined as alternative multi-user environment configurations; however, they 
are not necessary for system operation and are usually unused. 

In a MULTI-USER environment, the inittab file is set up so that init will 
create a process for each terminal on the system that the administrator sets 
up to respawn. 

For terminal processes, ultimately the shell will terminate because of an 
end-of-file either typed explicitly or generated as the result of hanging up. 
When init receives a signal telling it that a process it spawned has died, it 
records the fact and the reason it died in /etc/utmp and /etc/wtmp if it 
exists (see who{ 1)). A history of the processes spawned is kept in 
/etc/wtmp. 

To spawn each process in the inittab file, init reads each entry and for each 
entry that should be respawned, it forks a child process. After it has 
spawned all of the processes specified by the inittab file, init waits for one 
of its descendant processes to die, a powerfail signal, or until init is signaled 
by init or telinit to change the system’s run-level. When one of these condi- 
tions occurs, init re-examines the inittab file. New entries can be added to 
the inittab file at any time; however, init still waits for one of the above 
three conditions to occur. To get around this, init Q or init q command 
wakes init to re-examine the inittab file immediately. 
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If init receives a powerfail signal ( SIGPWR ) it scans inittab for special 
entries of the type powerfail and powerwait. These entries are invoked (if 
the run-levels permit) before any further processing takes place. In this 
way init can perform various cleanup and recording functions during the 
powerdown of the operating system. Note that in the SINGLE-USER state 
only powerfail and powerwait entries are executed. 

When init is requested to change run-levels (via telinit ), init sends the warn- 
ing signal (SIGTERM) to all processes that are undefined in the target run- 
level. init waits 5 seconds before forcibly terminating these processes via 
the kill signal (SIGKILL). 

Telinit 

Telinit , which is linked to letc/init, is used to direct the actions of init. It 
takes a one-character argument and signals init via the kill system call to 
perform the appropriate action. The following arguments serve as direc- 
tives to init. 

0-6 tells init to place the system in one of the run-levels 
0-6. 

a,b,c tells init to process only those /etc/inittab file entries 
having the a, b or c run-level set. These are pseudo- 
states, which may be defined to run certain commands, 
but which do not cause the current run-level to change. 

Q,q tells init to re-examine the /etc/inittab file. 

s,S tells init to enter the single user environment. When 

this level change is effected, the virtual system teletype, 
/dev/console, is changed to the terminal from which the 
command was executed. 

FILES 

/etc/inittab 

/etc/utmp 

/etc/wtmp 

/etc/ioctl.syscon 

/dev/console 

/dev/contty 

SEE ALSO 

getty(lM), termio(7). 

login(l), sh(l), who(l) in the U ser’ s Reference Manual. 
kill(2), inittab(4), utmp(4) in the Programmer' s Reference Manual. 

DIAGNOSTICS 

If init finds that it is respawning an entry from /etc/inittab more than 10 
times in 2 minutes, it will assume that there is an error in the command 
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string in the entry, and generate an error message on the system console. It 
will then refuse to respawn this entry until either 5 minutes has elapsed or it 
receives a signal from a user-spawned init ( telinit ). This prevents init from 
eating up system resources when someone makes a typographical error in 
the inittab file or a program is removed that is referenced in the inittab. 

WARNINGS 

Telinit and init can be run only by someone who is super-user. 

The S or s state must not be used indiscriminately in the /etc/inittab file. A 
good rule to follow when modifying this file is to avoid adding this state to 
any line other than the initdefault. 

The change to /etc/gettydefs described in the WARNINGS section of the 
gettydefs(4 ) manual page will permit terminals to pass 8 bits to the system 
as long as the system is in multi-user state (run level greater than 1). When 
the system changes to single-user state, the getty is killed and the terminal 
attributes are lost. To permit a terminal to pass 8 bits to the system in 
single-user state, after you are in single-user state, type: 

stty -istrip cs8 

BUGS 

Attempting to relink /dev/console with /dev/contty by typing a delete on 
the system console does not work. 

ORIGIN 

AT&T V.3 
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NAME 

inst - software installation tool 

SYNOPSIS 

inst [ — f source ] [ -r root ] [ -m machvalue ] ... 

DESCRIPTION 

inst is the installation tool for distributed software. By default, it will read 
from /dev/nrtape, but can read from other local or remote files or tape dev- 
ices. It is invoked automatically during a miniroot installation, and can be 
explicitly invoked under IRIX for some software. The miniroot is a small 
IRIX system that is copied from the distribution onto the disk, and then 
booted in such a way that the normal / and /usr file systems are not active. 
The normal file systems are then mounted by inst, usually as /root and 
/root/usr, so that they can be accessed during installation. 

Inst can be invoked as a normal IRIX command, but only certain software 
products can be installed on the system while it is running. Permission to 
install software on the system while it is running normally is part of the 
definition of the software product as it was created, and is based on whether 
it is possible and/or safe to do so. Options: 

— r root Set the root under which the new software will be installed. 

By default, this is /root during miniroot installations, and / 
under IRIX. 

-f source The default distribution source is /dev/nrtape, but can be 
over-ridden with this option, or with explicit “from” com- 
mands while running inst. 

-m machval Some software products contain multiple versions of the 
same file. Only one of them will be installed, based on the 
machine-specific values. By default, the values of CPU- 
BOARD and GFXBOARD are set automatically, based on 
the physical configuration of the machine. It may in some 
cases be necessary to explicitly set one or more machine- 
specific values to override the defaults. 

Inst has an extensive help command that can serve to answer specific ques- 
tions about the installation process. 

AUTHOR 

Donl Mathis 

FILES 

/usr/lib/inst/* Installation history and supporting files 

SEE ALSO 

versions(lm). 
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ORIGIN 

Silicon Graphics, Inc. 
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NAME 

killall - kill all active processes 

SYNOPSIS 

/ etc/killall [ signal ] 

/etc/killall [ — g ] [ — v ] [ signal ] [ name ...] 

DESCRIPTION 

killall is used by /etc/shutdown to kill all active processes not directly 
related to the shutdown procedure, i.e., not in the same process group. 

killall with no options terminates all processes with open files so that the 
mounted file systems will be unbusied and can be unmounted. 

killall sends signal (see kill(l)) to all processes not belonging to the above 
group of exclusions. If no signal is specified, a default of 9 is used. 

If name(s) are specified, then only processes with the given names are sent 
signals. The -v option reports if the signal was sucessfully sent. The -g 
option causes the signal to be sent to the named processes’ entire process 
group. 

FILES 

/etc/shutdown 
SEE ALSO 

fuser(lM), shutdown(lM). 

kill(l), ps(l) in the User's Reference Manual. 

signal(2) in the Programmer’ s Reference Manual. 

WARNINGS 

The killall command can be run only by the super-user. 

ORIGIN 

AT&T V.3 
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NAME 

labelit - provide labels for file systems 
SYNOPSIS 

/etc/labelit special [ fsname volume [ -n ] ] 

DESCRIPTION 

labelit can be used to provide labels for unmounted disk file systems or file 
systems being copied to tape. You must be superuser to run labelit . The -n 
option provides for initial labeling only (this destroys previous contents). 

With the optional arguments omitted, labelit prints current label values. 

The special name should be the physical disk section (e.g., 
/dev/dsk/dksOdlsO), or the cartridge tape (e.g., /dev/tape). The device may 
not be on a remote machine. 

The fsname argument represents the mounted name (e.g., root, ul, etc.) of 
the file system. 

Volume may be used to equate an internal name to a volume name applied 
externally to the disk pack, diskette or tape. 

For file systems on disk, fsname and volume are recorded in the superblock. 
SEE ALSO 

sh(l) in the U ser’ s Reference Manual. 
fs(4) in the Programmer’ s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

lboot - configure bootable kernel 
SYNOPSIS 

/usr/sbin/lboot [-m master ] [-s system ] [-b directory ] [-u unix] 
DESCRIPTION 

The lboot command is used to configure a bootable UNIX kernel. Master 
files in the directory master contain configuration information used by lboot 
when creating a kernel. The file system is used by lboot to determine which 
modules are to be configured into the kernel. 

If a module in master is specified in the system file via "INCLUDE:", that 
module will be included in the bootable kernel. For all included modules, 
lboot searches the boot directory for an object file with the same name as 
the file in master , but with a ".o" or ".a" appended. If found, this object is 
included when building the bootable kernel. 

For every module in the system file specified via "VECTOR:", lboot takes 
actions to determine if a hardware device corresponding to the specified 
module exists. Generally, the action is a memory read at a specified base, 
of the specfied size. If the read succeeds, the device is assumed to exist, 
and its module will also be included in the bootable kernel. 


To create the new bootable object file, the applicable master files are read 
and the configuration information is extracted and compiled. The output of 
this compilation is then linked with all included object files. 

Master files that are specified in the system file via "EXCLUDE:" are also 
examined; stubs are created for routines specified in the excluded master 
files that are not found in the included objects. 


The options are: 


— m master 


-s system 
— b directory 


-rROOT 


This option specifies the directory containing the master 
files to be used for the bootable kernel. The default mas- 
ter directory is $ROOT/usr/sysgen/master.d. 

This option specifies the name of the system file. The 
default system file is $ROOT/usr/sysgen/system. 

This option specifies the directory where object files are 
to be found. The default output directory is 
$ROOT/usr/sysgen/boot. 

If this option is specified, ROOT becomes the starting 
pathname when finding files of interest to lboot. Note 
that this option sets ROOT as the search path for include 
files used to generate the target kernel. If this option is 
not specified, the ROOT environment variable (if any) is 
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used instead. 

-p toolpath This option specifies that the tools (compiler, linker, etc.) 

used by Iboot to generate a new kernel are to be found in 
the directory toolpath. 

—v This option makes Iboot slighdy more verbose. 

-u unix This option specifies the name of the target kernel. By 

default, it is unix.new , unless the -t option is used, in 
which case the default is unix.install. 

This option displays debugging information about the 
devices and modules put in the kernel. 

This option tests if the existing kernel is up-to-date. If 
the kernel is not up-to-date, it prompts you to proceed. It 
compares the modification dates of the system file, the 
object files in the boot directory, and the configuration 
files in the master directory with that of the output ker- 
nel. It also “probes” for the devices specified with 
"VECTOR:" lines in the system file. If the devices have 
been added or removed, or if the kernel is out-of-date, it 
builds a new kernel, adding “.install” to the target name. 

EXAMPLE 

Iboot -s newsystem 

This will read the file named newsystem to determine which objects should 
be configured into the bootable object. 

FILES 

/usr/sysgen/system 

/usr/sysgen/master.d/* 

/usr/sysgen/boot/* 

SEE ALSO 

master(4) in the Programmer' s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

link, unlink - link and unlink files and directories 

SYNOPSIS 

/etc/link filel file2 
/etc/unlink file 

DESCRIPTION 

The link command is used to create a file name that points to another file. 
Linked files and directories can be removed by the unlink command; how- 
ever, it is strongly recommended that the rm{\) and rmdir{\) commands be 
used instead of the unlink command. 

The only difference between ln( 1) and link! unlink is that the latter do 
exactly what they are told to do, abandoning all error checking. This is 
because they directly invoke the link(2 ) and unlink( 2) system calls. 

SEE ALSO 

rm(l) in the U ser' s Reference Manual. 

link(2), unlink(2) in the Programmer' s Reference Manual. 

WARNINGS 

These commands can be run only by the super-user. 

ORIGIN 

AT&T V.3 
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NAME 

lpadmin - configure the LP spooling system 
SYNOPSIS 

/usr/lib/lpadmin -p printer [ options ] 

/usr/lib/lpadmin -xdest 
/usr/lib/lpadmin -d[dest] 

DESCRIPTION 

lpadmin configures line printer (LP) spooling systems to describe printers, 
classes and devices. It is used to add and remove destinations, change 
membership in classes, change devices for printers, change printer interface 
programs and to change the system default destination, lpadmin may not be 
used when the LP scheduler, lpsched{ 1M), is running, except where noted 
below. 

Exactly one of the -p, -d or -x options must be present for every legal 
invocation of lpadmin. 

-p printer names a printer to which all of the options below refer. If 

printer does not exist then it will be created. 

-xdest removes destination dest from the LP system. If dest is a 
printer and is the only member of a class, then the class will be 
deleted, too. No other options are allowed with -x. 

-d [dest] makes dest, an existing destination, the new system default 

destination. If dest is not supplied, then there is no system 
default destination. This option may be used when 
lpsched( 1M) is running. No other options are allowed with 
-d. 

The following options are only useful with -p and may appear in any order. 
For ease of discussion, the printer will be referred to as P below. 

-c class inserts printer P into the specified class. Class will be created 
if it does not already exist. 

-sprinter copies an existing printer’ s interface program to be the new 
interface program for P. 

-h indicates that the device associated with P is hardwired. This 

option is assumed when adding a new printer unless the -1 
option is supplied. 

-i interface establishes a new interface program for P. Interface is the 
path name of the new program. 

-1 indicates that the device associated with P is a login terminal. 

The LP scheduler, Ipsched, disables all login terminals 
automatically each time it is started. Before re-enabling P , its 
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current device should be established using Ipadmin. 

-mmodel selects a model interface program for P . Model is one of the 
model interface names supplied with the LP Spooling Utilities 
(see Models below). 

-rclass removes printer P from the specified class. If P is the last 
member of the class, then the class will be removed. 

-v device associates a new device with printer P . Device is the path- 

name of a file that is writable by Ip. Note that the same device 
can be associated with more than one printer. If only the -p 
and —v options are supplied, then Ipadmin may be used while 
the scheduler is running. 

Restrictions. 

When creating a new printer, the -v option and one of the -e, -i or -m 
options must be supplied. Only one of the — e, — i or — m options may be 
supplied. The -h and -1 keyletters are mutually exclusive. Printer and 
class names may be no longer than 14 characters and must consist entirely 
of the characters A-Z, a-z, 0-9 and _ (underscore). 

Models. 

Model printer interface programs are supplied with the LP Spooling Utili- 
ties. They are shell procedures which interface between Ipsched and dev- 
ices. All models reside in the directory /usr/spool/lp/model and may be 
used as is with Ipadmin -m. Copies of model interface programs may also 
be modified and then associated with printers using Ipadmin -i. The fol- 
lowing describes the models which may be given on the Ip command line 
using the -o keyletter: 

LQP-40 Letter quality printer using XON/XOFF protocol at 9600 baud. 
DQP-10 

Dot matrix draft quality printer using XON/XOFF protocol at 9600 
baud. 

EXAMPLES 

1. For a DQP-10 printer named cI8, it will use the DQP-10 model inter- 
face after the command: 

/usr/lib/lpadmin -pcI8 -mdqplO 

2. A LQP-40 printer called prl can be added to the lp configuration with 
the command: 

/usr/lib/lpadmin -pprl -v/dev/contty -mlqp40 


FILES 

/usr/spool/lp/* 
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SEE ALSO 

accept(lM), lpsched(lM). 

enable(l), lp(l), lpstat(l) in the User’ s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

lpsched, lpshut, lpmove - start/stop the LP scheduler and move requests 

SYNOPSIS 

/usr/lib/lpsched 

/usr/lib/Ipshut 

/usr/Iib/lpmove requests dest 
/usr/lib/lpmove destl dest2 

DESCRIPTION 

lpsched schedules requests taken by lp( 1) for printing on line printers 
(LP’s). 

Lpshut shuts down the line printer scheduler. All printers that are printing 
at the time lpshut is invoked will stop printing. Requests that were printing 
at the time a printer was shut down will be reprinted in their entirety after 
lpsched is started again. 

Lpmove moves requests that were queued by lp(l) between LP destinations. 
This command may be used only when lpsched is not running. 

The first form of the command moves the named requests to the LP destina- 
tion, dest. Requests are request ids as returned by lp( 1). The second form 
moves all requests for destination destl to destination dest2. As a side 
effect. Ip (1) will reject requests for destl . 

Note that lpmove never checks the acceptance status (see accept (\M)) for 
the new destination when moving requests. 

FILES 

/usr/spool/lp/* 

SEE ALSO 

accept(lM), lpadmin(lM). 

enable(l), lp(l), lpstat(l) in the User' s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

MAKEDEV - Create device special files 
SYNOPSIS 

/dev/MAKEDEV [alldevs] [mindevs] [links] [owners] [generic] [ dev- 
ice ] 

DESCRIPTION 

MAKEDEV creates specified device files in the current directory; it is pri- 
marily used for constructing the /dev directory. If invoked with no argu- 
ments, the options alldev and owners are assumed. The following argu- 
ments are recognized by MAKEDEV. 

ttys Creates tty (controlling terminal interface) files for CPU serial 

ports. In addition, creates special files for console, syscon, 
systty, keybd, mouse, dials, and tablet. See duart(l), con- 
sole (7), keyboard^ 7), and mouse(l) for details. 

cdsio Creates additional tty files enabled by using the Central Data 

serial board. 

Creates special files to support "pseudo terminals”. See 
ptyilM) for details. 

Creates special files for ESDI disks connected to an Inter- 
phase ESDI disk controller. See ips( 7M) for details. 

Creates special files for SCSI disks. See dksc(lM) for details. 

Creates special files for 1/4-inch cartridge tape drives con- 
nected to an ISI QIC-02 tape controller. See ta(7M) for 
details. 

tps Creates special files for SCSI 1/4-inch cartridge tape drive. 

See tps{ 7M) for details. 

magtape Creates special files for 1/2-inch tape drives connected to a 
Xylogics Model 772 tape controller. This includes the Cipher 
88X (and 99X) tape drive. See xmt{lM) for details. 

ikon Creates special files for hardcopy devices connected to an 

Ikon 10088 (or 10088A) printer controller. This includes 
Versatec TTL and Versatec differential compatible devices, as 
well as (Tektronix-compatible) Centronics printers. See ik(7) 
for details. 

gpib Creates special files for the National Instruments GPIB-1014 

controller and associated devices. See gpib( 7) for details. 

hi Creates special files for the hardware spinlock driver to use in 

process synchronization (IRIS-4D/GTX models only). 
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gro Creates special files for graphics output devices on IRIS-4D 

models such as the 4D/50, 60, 60G, 70 and 70G. 

grin Creates special files for graphics input devices. 

gm Creates the special file for the logical console device on the 

IRIS-4D/GT and 4D/GTX models. 

£3270 Creates the special files for the IBM 3270 interface controller. 

gse Creates the special files for the IBM 5080 interface controller. 

dn_ll Creates the special file for the 4DDN logical link driver. 

dn_netman Creates the special file for the 4DDN network management 
driver. 

audio Creates the special file for the bi-directional audio channel 

interface for the IRIS-4D/20 series. See audio (7) for details. 

pip Creates the special file for the parallel printer interface for the 

IRIS-4D/20 series. See plp(l ) for details. 

generic Creates miscellaneous, commonly used devices: tty, the con- 
trolling terminal device; mem, kmem, mmem, and null, the 
memory devices; prf, the kernel profiling interface; queue, the 
graphics event queue interface; and zero, a source of zeroed 
unnamed memory. See tt y(7), mem{ 7), prf( 7), and zero(J ) 
for details concerning these respective devices. 

links This option creates the dks, ips, tps, and qictape device files, 

and then creates links by which one can conveniently refer- 
ence them without knowing the configuration of the particular 
machine. The links root, rroot, swap, rswap, usr, rusr, vh and 
rvh are created to reference the current root, swap, usr and 
volume header partitions. In addition, tape and nrtape are 
linked to the tape drive device, if one exists. 

mindevs This option is shorthand for creating the generic, links, pty, 
ttys magtape, gro, and grin device files. 

alldevs This option creates all of the device special files listed above. 

owners This option changes the owner and group of the files in the 

current directory to the desired default state. 

SEE ALSO 

mknod(lM) 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

mkboottape - make a boot tape 
SYNOPSIS 

/etc/mkboottape [ -f output_file_name] filel file2 ... file20 
DESCRIPTION 

mkboottape builds a special directory which contains the list of file names 
and their logical block number relative to the beginning of the output file. 
There may be no more than twenty files and the file names must be less than 
or equal to sixteen characters. The -f option may be used to specify an 
alternate output file or device. 

Typical use for this program is to create the output file which is dd'e d to 
tape using a blocking factor of 16K. The prom monitor knows about this 
special directory and can boot any one of the files found in the directory. 

Unless you have means to create a stand alone program this utility is use- 
less. 

SEE ALSO 

dd(l) 

AUTHOR 

Rick McNeal 

ORIGIN 

MIPS Computer Systems 
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NAME 

mkcentpr - register a Centronics-interface printer with LP 
SYNOPSIS 

/usr/spool/lp/etc/util/mkcentpr printer printer-type 
DESCRIPTION 

mkcentpr creates a filter program that controls a printer that communicates 
with the IRIS through a Centronics interface, then registers the printer with 
LP. A log file is also created, printer is the name you give the printer (see 
lpadmin( 1M)). printer-type is the type of printer connected to Idevlcent. 
You must specify the printer type by providing one of the following keys: 

mils for Mitsubishi 

tek for the Tektronics 4692 

vers for the Versatec 

After running this program, you might consider making this printer the 
default printer using lpadmin(lM). 

Run this program as superuser from directory lusrlspoolllpl etc! util. 

FILES 

/usr/spool/lp/etc/log/<printer>-log 

/usr/spool/lp/interface/<printer> 

/dev/cent 

SEE ALSO 

accept(lM), addclient(lM), enable(l), lp(l), lpadmin(lM), lpsched(lM), 
lpshut(lM), lpstat(l), mknetpr(lM), rmprinter(lM). 

AUTHOR 

Glen Williams 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

mkfs - construct a file system 
SYNOPSIS 

/etc/mkfs special [proto] 

/etc/mkfs special blocks inodes sectors heads cgsize cgalign ialign 
[proto] 

DESCRIPTION 

mkfs constructs a file system by writing on the special file using the values 
found in the remaining arguments of the command line. The command 
waits 10 seconds before starting to construct the file system. During this 
10-second pause the command can be aborted by interrupt mkfs. 

When the first form of mkfs is used, mkfs searches /dev for the volume 
header device that special uses. Once the volume header has been exam- 
ined, mkfs will then proceed to assign values to the filesystem parameters. 

If the second form of mkfs is used, then all the filesystem parameters must 
be specified from the command line. Each argument other than special and 
proto is interpreted as a decimal number. 

The filesystem parameters are as follows: 

blocks is the number of physical (512 byte) disk blocks the file 
system will occupy. 

inodes is the number of inodes the filesystem should have as a 
minimum. 

heads is the number of heads on the physical medium. 

sectors is the number of sectors per track of the physical 

medium. 

cgfsize is the size of each cylinder group, in disk blocks, 
approximately. 

cgalign is the boundary, in disk blocks, that a cylinder group 
should be aligned to. 

ialign is the boundary, in disk blocks, that each cylinder groups 
inode list should be aligned to. 

Once mkfs has the filesystem parameters it needs it then builds a file system 
containing two directories. The filesystems root directory is created with 
one entry, the lost+found directory. The lost+found directory is filled with 
zeros out to approximately 10 disk blocks so as to allow space for/sc£(lM) 
to reconnect disconnected files. The boot program block (block zero) is left 
uninitialized. 

If the the optional proto argument is given, mkfs uses it as a prototype file 
and will take its directions from that file. Note that the blocks and inodes 
specifiers in the proto file are provided for backwards compatibility, but are 
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otherwise unused. The prototype file contains tokens separated by spaces 
or new-lines. A sample prototype specification follows (line numbers have 
been added to aid in the explanation): 


1 . 

/stand Jdislcboot 

2. 

4872 110 

3. 

d— 777 3 1 

4. 

usr 

d— 777 3 1 

5. 

sh 

755 3 1 /bin/sh 

6. 

ken 

d— 755 6 1 

7. 


$ 

8. 

bO 

b— 644 3 10 0 

9. 

cO 

c— 644 3 10 0 

10 

fifo 

p — 644 3 1 

11 

slink 

1 — 644 3 1 /a/symbolic/link 

12 

$ 


13. 

$ 



Line 1 in the example is the name of a file to be copied onto block zero as 
the bootstrap program. 

Line 2 specifies the number of physical (512 byte) blocks the file system is 
to occupy and the number of i-nodes in the file system. These values are 
ignored. 

Lines 3-11 tell mkfs about files and directories to be included in this file sys- 
tem. 

Line 3 specifies the root directory. 

lines 4-6 and 8-11 specifies other directories and files. 

The $ on line 7 tells mkfs to end the branch of the file system it is on, and 
continue from the next higher directory. The $ on lines 12 and 13 end the 
process, since no additional specifications follow. 

File specifications give the mode, the user ID, the group ID, and the initial 
contents of the file. Valid syntax for the contents field depends on the first 
character of the mode. 

The mode for a file is specified by a 6-character string. The first character 
specifies the type of the file. The character range is -bcdpl to specify regu- 
lar, block special, character special, directory files, named pipes (fifos) and 
symbolic links, respectively. The second character of the mode is either u 
or - to specify set-user-id mode or not. The third is g or - for the set- 
group-id mode. The rest of the mode is a 3 digit octal number giving the 
owner, group, and other read, write, execute permissions (see chmod( 1)). 
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Two decimal number tokens come after the mode; they specify the user and 
group IDs of the owner of the file. 

If the file is a regular file, the next token of the specification may be a path 
name whence the contents and size are copied. If the file is a block or char- 
acter special file, two decimal numbers follow which give the major and 
minor device numbers. If the file is a symbolic link, the next token of the 
specification is used as the contents of the link. If the file is a directory, 
mkfs makes the entries . and .. and then reads a list of names and (recur- 
sively) file specifications for the entries in the directory. As noted above, 
the scan is terminated with the token $. 

SEE ALSO 

chmod(l) in the U ser’ s Reference Manual. 
dir(4), fs(4) in the Programmer' s Reference Manual. 

BUGS 

With a prototype file, it is not possible to copy in a file which requires 
indirect extents, nor is there a way to specify hard links. 

ORIGIN 

AT&T V.3 
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NAME 

mknetpr - provide access to a remote printer 
SYNOPSIS 

/usr/spool/lp/etc/util/mknetpr printer host netprinter 
DESCRIPTION 

mknetpr creates a filter program that accesses a real printer over the net- 
work and registers the “printer” with the LP system. A log file is also 
created, printer is the name you give the printer (see lpadmin(\M)). host is 
the name of an IRIS that has a real printer attached to it. netprinter is the 
name of the real printer on the remote machine. If the remote printer is a 
LaserWriter and you want to print troff( 1) files, you need to duplicate much 
of the software that is on the host machine in order to generate a PostScript 
file that can be transmitted to the remote printer. Many of the filters that 
prepare data for the LaserWriter default their output to a printer or class of 
printers called PostScript. Therefore, it is a good idea to use the name 
PostScript for the printer. You can override such action using the “destina- 
tion” switch in the various programs. 

After running this program, you might consider making this printer the 
default printer using lpadmin{ 1M). Run this program as superuser from 
directory lusr/spool/lp/etc/util. 

This program installs a printer filter program that appears to the LP system 
as a real printer filter. The data passed to the filter is transmitted to the host 
machine, then submitted to the remote printer’s queue using lp. 

FILES 

/usr/spool/lp/etc/log/<printer>-log 

/usr/spool/lp/interface/<printer> 

SEE ALSO 

accept(lM), addclient(lM), enable(l), lp(l), lpadmin(lM), lpsched(lM), 
lpshut(lM), lpstat(l), rmprinter(lM). 

AUTHOR 

Glen Williams 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

mknod - build special file 
SYNOPSIS 

/etc/mknod name b | c major minor 
/etc/mknod name p 

DESCRIPTION 

mknod makes a directory entry and corresponding i-node for a special file. 

The first argument is the name of the entry. The UNIX System convention 
is to keep such files in the /dev directory. 

In the first case, the second argument is b if the special file is block-type 
(disks, tape) or c if it is character-type (other devices). The last two argu- 
ments are numbers specifying the major device type and the minor device 
(e.g., unit, drive, or line number). They may be either decimal or octal. 
The assignment of major device numbers is specific to each system. The 
information is contained in the system source file /usr/sysgen/README. 
You must be the super-user to use this form of the command. 

The second case is the form of the mknod that is used to create FIFO’s 
(a.k.a named pipes). 

SEE ALSO 

mknod(2) in the Programmer’ s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

mkPS - register a LaserWriter printer with LP 
SYNOPSIS 

/usr/spool/lp/etc/util/mkPS printer tty 
DESCRIPTION 

mkPS creates a filter program that controls a LaserWriter printer, then regis- 
ters the printer with LP. A log file is also created, printer is the name you 
give the printer (see Ipadmin (1M)). tty is a tty in /dev that the printer is 
attached to. After running this program, you might consider making this 
printer the default printer using lpadmin{ 1M). 

Run this program as superuser from directory /usr/spoolllp/etc/util. 

FILES 

/dev/ttyn 

/usr/spool/lp/transcript/<printer>-log 

/usr/spool/lp/interface/<printer> 

SEE ALSO 

accept(lM), addclient(lM), enable(l), lp(l), Ipadmin(lM), lpsched(lM), 
lpshut(lM), lpstat(l), mknetpr(lM), rmprinter(lM). 

ORIGIN 

Adobe Systems Incorporated 
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NAME 

mount, umount - mount and dismount filesystems 

SYNOPSIS 

/etc/mount [ -p ] 

/etc/mount -a[cfv] [ -t type ] 

/etc/mount [ — cfrv ] [ — t type ] [ -o options ] fsname dir 
/etc/mount [ — cfv ] fsname I dir 

/etc/umount [ -h host ] [ -fkrv ] 

/etc/umount -a[kv] 

/etc/umount [ -kv ] 

/etc/umount [ -t type ] 

DESCRIPTION 

Mount announces to the system that a filesystem fsname is to be attached to 
the file tree at the directory dir. The directory dir must already exist. It 
becomes the name of the newly mounted root. The contents of dir are hid- 
den until the filesystem is unmounted. If fsname is of the form host:path the 
filesystem type is assumed to be nfs. 

Umount announces to the system that the filesystem fsname previously 
mounted on directory dir should be removed. Either the filesystem name or 
the mounted-on directory may be used. 

Mount and umount maintain a table of mounted filesystems in letclmtab, 
described in mtab( 4). If invoked without an argument, mount displays the 
table. If invoked with only one of fsname or dir mount searches the file 
! etc! f stab (see j 'stab (4)) for an entry whose dir or fsname field matches the 
given argument. For example, if this line is in letclfstab : 

/dev/usr /usr efs rw 0 0 

then the commands mount /usr and mount /dev/usr are shorthand for 
mount /dev/usr /usr. 

MOUNT OPTIONS 

— p Print the list of mounted filesystems in a format suitable for use in 

letclfstab. 

-a Attempt to mount all the filesystems described in letclfstab. (In 
this case, fsname and dir are taken from letclfstab.) If a type is 
specified all of the filesystems in letclfstab with that type are 
mounted. Filesystems are not necessarily mounted in the order 
listed in letclfstab. 

— c Invoke fsstat (1M) on each filesystem being mounted, and if it indi- 

cates that the filesystem is dirty, call fsck(]M) to clean the filesys- 
tem. fsck is passed the -D and -y options. 
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-f Fake a new /etc/mtab entry, but do not actually mount any filesys- 
tems. 

-v Verbose - mount displays a message indicating the filesystem 
being mounted. 

-t The next argument is the filesystem type. The accepted types are 
dbg, efs and nfs; see f stab (4) and dbg (4) for a description of these 
filesystem types. 

-r Mount the specified filesystem read-only. This is a shorthand for: 
mount —o ro fsname dir 

Physically write-protected and magnetic tape filesystems must be 
mounted read-only, or errors occur when access times are updated, 
whether or not any explicit write is attempted. 

-o Specify options, a list of comma-separated words described in 
fstab( 4). 

UMOUNT OPTIONS 

-h host Unmount all filesystems listed in letc/mtab that are remote- 
mounted from host. 

-a Attempt to unmount all the filesystems currently mounted (listed in 
/etc/mtab). In this case, fsname is taken from /etc/mtab. 

-k Attempt to kill processes which have open files or current direc- 
tories on the filesystem being unmounted. 

-t Unmounts all filesystems of a given filesystem type. The accepted 
types are dbg, efs and nfs. 

-v Verbose - amount displays a message indicating the filesystem 
being unmounted. 

EXAMPLES 

mount /dev/usr /usr mount a local disk 

mount -at efs mount all efs filesystems 

mount -t nfs server:/usr/src /usr/src mount remote filesystem 

mount server:/usr/src /usr/src same as above 

mount -o hard server:/usr/src /usr/src same as above but hard mount 

mount -p > /etc/fstab save current mount state 

FILES 

/etc/fstab filesystem table 

/etc/mtab mount table 

SEE ALSO 

fstab(4), mtab(4) 

mountd(lM), nfsd(lM), nfsmount(2) if NFS is installed. 
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BUGS 

Mounting filesystems full of garbage crashes the system. 

If the directory on which a filesystem is to be mounted is a symbolic link, 
the filesystem is mounted on the directory to which the symbolic link refers, 
rather than being mounted on top of the symbolic link itself. 

ORIGIN 

Sun Microsystems 

Extensions by Silicon Graphics, Inc. 
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NAME 

mountall, umountall - mount, unmount multiple file systems 

SYNOPSIS 

/etc/mountall 

/etc/umountall 

DESCRIPTION 

These commands may be executed only by the super-user. 

Before each file system is mounted, it is checked using fsstat(\M) to see if 
it appears mountable. If the file system does not appear mountable, it is 
checked, using/sc£(lM), before the mount is attempted. 

umountall causes all mounted file systems except root to be unmounted. 

SEE ALSO 

fsck(lM), fsstat(lM), fuser(lM), mount(lM). 

sysadm(l) in the U ser' s Reference Manual. 

signal(2), fstab(4) in the Programmer' s Reference Manual. 

DIAGNOSTICS 

No messages are printed if the file systems are mountable and clean. 

Error and warning messages come from /scA(lM), fsstat(lM), and 
mount{ 1M). 

ORIGIN 

AT&T V.3 
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NAME 

multi - switch the system to multi-user mode 

SYNOPSIS 

/etc/multi 

DESCRIPTION 

Multi switches the system to multi-user mode if it was in single-user mode 
or causes it to re-read its /etc/inittab file and turn the appropriate getty s on 
and off. Multi is a shell script that invokes /etc/telinit. 

SEE ALSO 

single(lM), init(lM), getty(lM), inittab(4). 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

mvdir - move a directory 
SYNOPSIS 

/etc/mvdir dimame name 
DESCRIPTION 

mvdir moves directories within a file system. Dimame must be a directory. 
If name does not exist, it will be created as a directory. If name does exist, 
dimame will be created as name! dimame. Dimame and name may not be 
on the same path; that is, one may not be subordinate to the other. For 
example: 


mvdir x/y x/z 


is legal, but 


mvdir x/y x/y/z 


is not. 

SEE ALSO 

mkdir(l), mv(l) in the V ser s Reference Manual. 
WARNINGS 

Only the super-user can use mvdir. 

ORIGIN 

AT&T V.3 
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NAME 

named - Internet domain name server 
SYNOPSIS 

/usr/etc/named [ -d debuglevel ] [ -p port# ] [{— b} bootfile ] 
DESCRIPTION 

Named is the Internet domain name server. See RFC 1034 for more infor- 
mation on the Internet name-domain system. Without any arguments, 
named will read the default boot file lusr/etclnamed.dl named. boot , read any 
initial data and listen for queries. 

Options are: 

-d Print debugging information. A number after the “d” determines 
the level of messages printed. 

-p Use a different port number. The default is the standard port 
number as listed in /etc/services. 

-b Use an alternate boot file. This is optional and allows you to 
specify a file with a leading dash. 

Any additional argument is taken as the name of the boot file. The boot file 
contains information about where the name server is to get its initial data. 
If multiple boot files are specified, only the last is used. Lines in the boot 
file cannot be continued on subsequent lines. The following is a small 
example: 


; boot file for name server 

» 

directory /usr/etc/named.d 


; type domain 


source host/file 


backup file 


cache 



primary 

Berkeley.EDU 

berkeley.edu.zone 

primary 

32.128.IN-ADDR.ARPA 

ucbhosts.rev 

secondary 

CC .B erkeley . EDU 

128.32.137.8 128.32.137.3 

secondary 

6.32. 128.IN-ADDR.ARPA 

128.32.137.8 128.32.137.3 

primary 

0.0.127.IN-ADDR.ARPA 


forwarders 

10.0.0.78 10.2.0.78 



root.cache 


cc.zone.bak 

cc.rev.bak 

localhost.rev 


; slave 


The “directory” line causes the server to change its working directory to 
the directory specified. This can be important for the correct processing of 
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$INCLUDE files in primary zone files. 

The “cache” line specifies that data in “rootxache” is to be placed in the 
backup cache. Its main use is to specify data such as locations of root 
domain servers. This cache is not used during normal operation, but is used 
as “hints” to find the current root servers. The file “rootxache” is in the 
same format as “berkeley.edu.zone”. There can be more than one 
“cache” file specified. The cache files are processed in such a way as to 
preserve the time-to-live’s of data dumped out. Data for the root 
nameservers is kept artificially valid if necessary. 

The first “primary” line states that the file “berkeley.edu.zone” contains 
authoritative data for the “Berkeley.EDU” zone. The file 
“berkeley.edu.zone” contains data in the master file format described in 
RFC1034. All domain names are relative to the origin, in this case, 
“Berkeley.EDU” (see below for a more detailed description). The second 
“primary” line states that the file “ucbhosts.rev” contains authoritative 
data for the domain “32.128.IN-ADDR.ARPA,” which is used to translate 
addresses in network 128.32 to hostnames. Each master file should begin 
with an SOA record for the zone (see below). 

The first “secondary” line specifies that all authoritative data under 
“CC.Berkeley.EDU” is to be transferred from the name server at 
128.32.137.8. If the transfer fails it will try 128.32.137.3 and continue try- 
ing the addresses, up to 10, listed on this line. The secondary copy is also 
authoritative for the specified domain. The first non-dotted-quad address on 
this line will be taken as a filename in which to backup the transfered zone. 
The name server will load the zone from this backup file if it exists when it 
boots, providing a complete copy even if the master servers are unreach- 
able. Whenever a new copy of the domain is received by automatic zone 
transfer from one of the master servers, this file will be updated. The 
second “secondary” line states that the address-to-hostname mapping for 
the subnet 128.32.136 should be obtained from the same list of master 
servers as the previous zone. 

The “forwarders” line specifies the addresses of sitewide servers that will 
accept recursive queries from other servers. If the boot file specifies one or 
more forwarders, then the server will send all queries for data not in the 
cache to the forwarders first. Each forwarder will be asked in turn until an 
answer is returned or the list is exhausted. If no answer is forthcoming 
from a forwarder, the server will continue as it would have without the for- 
warders line unless it is in “slave” mode. The forwarding facility is useful 
to cause a large sitewide cache to be generated on a master, and to reduce 
traffic over links to outside servers. It can also be used to allow servers to 
run that do not have access directly to the Internet, but wish to act as though 
they do. 
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The “slave” line (shown commented out) is used to put the server in slave 
mode. In this mode, the server will only make queries to forwarders. This 
option is normally used on machine that wish to run a server but for physi- 
cal or administrative reasons cannot be given access to the Internet, but 
have access to a host that does have access. 

The “sortlist” line can be used to indicate networks that are to be preferred 
over other, unlisted networks. Queries for host addresses from hosts on the 
same network as the server will receive responses with local network 
addresses listed first, then addresses on the sort list, then other addresses. 
This line is only acted on at initial startup. When reloading the nameserver 
with a SIGHUP, this line will be ignored. 

The master file consists of control information and a list of resource records 
for objects in the zone of the forms: 

$INCLUDE <filename> <opt_domain> 

$ORIGIN <domain> 

<domain> <opt_ttl> <opt_class> <type> <resource_record_data> 

where domain is for root, for the current origin, or a standard 
domain name. If domain is a standard domain name that does not end with 
the current origin is appended to the domain. Domain names ending 
with are unmodified. The optjlomain field is used to define an origin 
for the data in an included file. It is equivalent to placing a $ORIGIN state- 
ment before the first line of the included file. The field is optional. Neither 
the optjlomain field nor $ORIGIN statements in the included file modify 
the current origin for this file. The optjtl field is an optional integer 
number for the time-to-live field. It defaults to zero, meaning the minimum 
value specified in the SOA record for the zone. The opt_class field is the 
object address type; currently only one type is supported, IN, for objects 
connected to the DARPA Internet. The type field contains one of the fol- 
lowing tokens; the data expected in the resource record data field is in 
parentheses. 

A a host address (dotted quad) 

NS an authoritative name server (domain) 

MX a mail exchanger (domain) 

CNAME the canonical name for an alias (domain) 

SOA marks the start of a zone of authority (domain of originating host, 
domain address of maintainer, a serial number and the following 
parameters in seconds: refresh, retry, expire and minimum TTL 
(see RFC 1034)) 
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MB 

a mailbox domain name (domain) 


MG 

a mail group member (domain) 


MR 

a mail rename domain name (domain) 


NULL 

a null resource record (no format or data) 


WKS 

a well know service description (not implemented yet) 

PTR 

a domain name pointer (domain) 


HINFO 

host information (cpujype OS_type) 


MINFO 

mailbox or mail list information (request_domain error_domain) 


Resource records normally end at the end of a line, but may be continued 
across lines between opening and closing parentheses. Comments are intro- 
duced by semicolons and continue to the end of the line. 

Each master zone file should begin with an SOA record for the zone. An 
example SOA record is as follows: 

@ IN SOA ucbvax.Berkeley.EDU. rwh.ucbvax.Berkeley.EDU. ( 

2.89 ; serial 

10800 ; refresh 

3600 ; retry 

3600000 ; expire 
86400 ) ; minimum 

The SOA lists a serial number, which should be changed each time the mas- 
ter file is changed. Secondary servers check the serial number at intervals 
specified by the refresh time in seconds; if the serial number changes, a 
zone transfer will be done to load the new data. If a master server cannot 
be contacted when a refresh is due, the retry time specifies the interval at 
which refreshes should be attempted until successful. If a master server 
cannot be contacted within the interval given by the expire time, all data 
from the zone is discarded by secondary servers. The minimum value is the 
time-to-live used by records in the file with no explicit time-to-live value. 

NOTES 

The boot file directives “domain” and “suffixes” have been obsoleted by 
a more useful resolver based implementation of suffixing for partially 
qualified domain names. The prior mechanisms could fail under a number 
of situations, especially when then local nameserver did not have complete 
information. 

The following signals have the specified effect when sent to the server pro- 
cess using the kill(l) command. 
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SIGHUP Causes server to read named.boot and reload the database. 

SIGINT Dumps current data base and cache to 
/usr/tmp/named_dump.db 

SIGIOT Dumps statistics data into /usr/tmp/named.stats. Statistics data 
is appended to the file. 

SIGUSR1 Turns on debugging; each SIGUSR1 increments debug level. 
SIGUSR2 Turns off debugging completely. 

FILES 

/usr/etc/named.pid the process id 

/usr/etc/named.d/named.boot name server configuration boot file 
/usr/tmp/named.run debug output 

/usr/tmp/named_dump.db dump of the name server database 

/usr/tmp/named.stats nameserver statistics data 

SEE ALSO 

kill(l), gethostbyname(3N), resolver(3N), hostname(4), resolver(4), 

RFC 1032, RFC1033, RFC1034, RFC1035, RFC974, 

BIND Name Server Operations Guide in the IRIS-4D TCP HP User’ s Guide 

ORIGIN 

4.3BSD 
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NAME 

ncheck - generate path names from i-numbers 
SYNOPSIS 

/etc/ncheck [ — i i-numbers ] [ -a ] [ -s ] [ file-system ] 

DESCRIPTION 

ncheck with no arguments generates a path-name vs. i-number list of all 
files on a set of default file systems (see letc/fstab). Names of directory 
files are followed by /.. 

The options are as follows: 

-i limits the report to only those files whose i-numbers follow. 

-a allows printing of the names . and ... which are ordinarily 

suppressed. 

-s limits the report to special files and files with set-user-ID mode. 
This option may be used to detect violations of security policy. 

File system must be specified by the file system’s special file in /dev. 

ncheck is only useful with extent file systems. 

The report should be sorted so that it is more useful. 

SEE ALSO 

fsck(lM). 

sort(l) in the U ser' s Reference Manual. 

DIAGNOSTICS 

If the file system structure is not consistent, ?? denotes the “parent” of a 
parentless file and a path-name beginning with ... denotes a loop. 

ORIGIN 

AT&T V.3 
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NAME 

network - network initialization and shutdown script 
SYNOPSIS 

/etc/init.d/network [ start I stop ] 

DESCRIPTION 

The network shell script is called during system startup from tetdrc2 to ini- 
tialize the standard and optional network devices and daemons. The script 
is called during system shutdown from /etc/rcO to gracefully kill the dae- 
mons and inactivate the devices. 

When called with the start argument, the network script does the following, 
using the various configuration flags described below: 

• Defines the hostname and hostid based on the name in letclsysjd and its 
corresponding Internet address in letc/hosts. 

• Checks that the host’s Internet address is not the default 192.0.2.1 Inter- 
net test address. If the address is the default address, the software is 
configured for standalone mode. An Internet address other than the 
default must be chosen in order to configure the network properly. See 
the network administration chapter in the TCP/IP User’ s Guide for infor- 
mation on selecting an address. 

• Initializes the network interfaces. The primary and secondary (if 
installed) ethemet interfaces are initialized automatically. The HyperNet 
interface is initialized if the hypemet configuration flag is on. Each inter- 
face must have an unique Internet address and name in letc/hosts. The 
script derives the names from letclsysjd. The prefix gate- is prepended 
to the host name to generate the second interface’s name. The suffix -hy 
is appended to generate the HyperNet interface’s name. For example: 

191.50.1.7 yosemite 
191.50.2.49 gate-yosemite 
191.51.0.88 yosemite-hy 

If your ERIS-4D has more than 2 ethemet controllers, edit the script to 
configure the additional interfaces after the standard ones. 

• Starts the routing and portmap daemons. 

• Defines the YP domain name, starts the YP and NFS daemons and 
mounts NFS filesystems (if NFS is installed). 

• Starts the inetd, named, timed, timeslave and rwhod daemons. 

• Starts the 4DDN software (if installed). 

When called with the stop argument, the network script gracefully ter- 
minates daemons in the correct order, unmounts NFS filesystems and inac- 
tivates the network interfaces. 
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CONFIGURATION FLAGS 

A deamon or subsystem is enabled if its configuration flag in the /etc/config 
directory in the “on” state. If a flag file is missing, the flag is considered 
off. Use the chkconfig (1M) command to turn a flag on or off. For example, 

chkconfig timed on 

enables the timed flag. When invoked without arguments, chkconfig prints 
the state of all known flags. 

There are two special flags: verbose and network. The verbose flag controls 
the printing of the names of daemons as they are started and the printing of 
NFS-mounted filesystem names as they are mounted and unmounted. The 
network flag allows incoming and outgoing traffic. This flag can be set off if 
you need to isolate the machine from network without removing cables. 

The following table lists the configuration flags used to initialize standard 
and optional software. 


Flag 

named 

rwhod 

timed 

timeslave 

hypemet 

nfs 

yp 

ypserv 

ypmaster 

4DDN 


Action if “on” 

Start 4.3BSD Internet domain name server. 

Start 4.3BSD rwho daemon. 

Start 4.3BSD time synchronization daemon. 

Start SGI time synchronization daemon. 

Initialize HyperNet controller and routes. 

Start NFS daemons, mount NFS filesystems. 

Enable Yellow Pages, start ypbind daemon. 

If yp is on, become a YP server. 

If yp is on, become the YP master; start passwd server 
ypserv should be on, too. 

Initialize 4DDN (DECnet connectivity) software. 


Site-dependent options for daemons belong in “options” files in 
/etc/config. Certain daemons require options so their options file must con- 
tain valid information. See the TCP/IP User' s Guide and the daemon’s 
manual page in section 1M for details on valid options. 


File 

Status 


ifconfig-1. options 

optional 

(for primary network interface) 

ifconfig-2.options 

optional 

(for gateway network interface) 

ifconfig-hy .options 

optional 

(for HyperNet interface) 

routed.options 

optional 


timed.options 

optional 


timeslave.options 

required 


ypserv.options 

optional 



Site-dependent configuration commands to start and stop local daemons, 
add static routes and publish arp entries should be put in a separate shell 
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script called letc/init.d/network.local. Make symbolic links in /etc/rcO.d 
and Ietclrc2.d to this file to have it called during system startup and shut- 
down: 

In -s /etc/init.d/network.local /etc/rc0.d/K39network 
In -s /etc/init.d/network.local /etc/rc2.d/S31 network 

See / etc linit.dl network for the general format of the script. 

FILES 

/etc/init.d/network 

/etc/rc0.d/K40network linked to network 

/etc/rc2.d/S30network linked to network 

/etc/config configuration flags and options files 

/etc/sys_id host name 

/etc/hosts Internet address-name database 

SEE ALSO 

chkconfig(lM), rcO(lM), rc2(lM) 

TCP/IP User s Guide for the IRIS-4D Series. 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

newaliases - rebuild the data base for the mail aliases file 

SYNOPSIS 

newaliases 

DESCRIPTION 

Newaliases rebuilds the random access data base for the mail aliases file 
lusr/libl aliases. It must be run each time lusr/liblaliases is changed in order 
for the change to take effect, unless sendmail has been configured to 
automatically rebuild the database, which is the default. 

SEE ALSO 

aliases(4), sendmail(lM) 

ORIGIN 

4.3BSD 
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NAME 

newgrp - log in to a new group 
SYNOPSIS 

newgrp [-] [ group ] 

DESCRIPTION 

newgrp changes a user’s group identification. The user remains logged in 
and the current directory is unchanged, but calculations of access permis- 
sions to files are performed with respect to the new real and effective group 
IDs. The user is always given a new shell, replacing the current shell, by 
newgrp, regardless of whether it terminated successfully or due to an error 
condition (i.e., unknown group). 

Exported variables retain their values after invoking newgrp-, however, all 
unexported variables are either reset to their default value or set to null. 
System variables (such as PS1, PS2, PATH, MAIL, and HOME), unless 
exported by the system or explicitly exported by the user, are reset to 
default values. For example, a user has a primary prompt string (PS 1) other 
than $ (default) and has not exported PS1. After an invocation of newgrp , 
successful or not, their PS1 will now be set to the default prompt string $. 
Note that the shell command export (see sh{ 1)) is the method to export vari- 
ables so that they retain their assigned value when invoking new shells. 

With no arguments, newgrp changes the group identification back to the 
group specified in the user’s password file entry. This is a way to exit the 
effect of an earlier newgrp command. 

If the first argument to newgrp is a — , the environment is changed to what 
would be expected if the user actually logged in again as a member of the 
new group. 

A password is demanded if the group has a password and the user does not, 
or if the group has a password and the user is not listed in /etc/group as 
being a member of that group. 

FILES 

/etc/group system’s group file 

/etc/passwd system’s password file 

SEE ALSO 

login(l), sh(l) in the U ser' s Reference Manual. 

group(4), passwd(4), environ(5) in the Programmer’ s Reference Manual. 

BUGS 

There is no convenient way to enter a password into /etc/group. Use of 
group passwords is not encouraged, because, by their very nature, they 
encourage poor security practices. Group passwords may disappear in the 
future. 
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ORIGIN 

AT&T V.3 
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NAME 

ping - send ICMP ECHO_REQUEST packets to network hosts 
SYNOPSIS 

/usr/etc/ping [-dfnqrvR] host [packetsize [count [preload]]] 
DESCRIPTION 

The DARPA Internet is a large and complex aggregation of network 
hardware, connected together by gateways. Tracking a single-point 
hardware or software failure can often be difficult. Ping utilizes the ICMP 
protocol’s mandatory ECHO_REQUEST datagram to elicit an ICMP 
ECHO_RESPONSE from a host or gateway. ECHO_REQUEST datagrams 
(“pings”) have an IP and ICMP header, followed by a struct timeval, and 
then an arbitrary number of “pad” bytes used to fill out the packet. Default 
datagram length is 64 bytes, but this may be changed using the packetsize 
command-line option. 

Other options are: 

-v Verbose output. ICMP packets other than ECHO RESPONSE that 
are received are listed. 

-q Quiet output. Nothing is displayed except the summary line on 
termination. 

-n Numeric output only. No attempt will be made to lookup symbolic 
names for host addresses. Useful if your nameserver if flakey or 
for hosts not in the database. 

-f Flood ping. Outputs packets as fast as they come back or one hun- 
dred times per second, whichever is more. For every 
ECHO_REQUEST sent a period V is printed, while for ever 
ECHO_REPLY received a backspace is printed. This provides a 
rapid display of how many packets are being dropped. 

-R Record Route. Includes the RECORD_ROUTE option in the 
ECHO_REQUEST packet and displays the route buffer on 
returned packets. Note that the IP header is only large enough for 
six such routes. Many hosts ignore or discard this option. 

-r Bypass the normal routing tables and send directly to a host on an 
attached network. If the host is not on a directly-attached network, 
an error is returned. This option can be used to ping a local host 
through an interface that has no route through it (e.g., after the 
interface was dropped by routed{\M)). 

— d Set the SO_DEBUG option on the socket being used. 

When using ping for fault isolation, it should first be run on the local host, 
to verify that the local network interface is up and running. Then, hosts and 
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gateways further and further away should be “pinged”. Ping sends one 
datagram per second, and prints one line of output for every 
ECHO_RESPONSE returned. No output is produced if there is no 
response. If an optional count is given, only that number of requests is sent. 
Round-trip times and packet loss statistics are computed. When all 
responses have been received or the program times out (with a count 
specified), or if the program is terminated with an interrupt (SIGINT), a 
brief summary is displayed. If preload is given, ping sends that many pack- 
ets as fast as possible before falling into its normal mode of behavior. 

This program is intended for use in network testing, measurement and 
management. It should be used primarily for manual fault isolation. 
Because of the load it could impose on the network, it is unwise to use ping 
during normal operations or from automated scripts. 

When not using the flood option specified with —f, the first interrupt, usually 
generated by control-C or DEL, causes ping to wait for its outstanding 
requests to return. It will wait no longer than the longest round trip time 
encountered by previous, successful pings. The second interrupt stops ping 
immediately. 

DETAILS 

(For those that care.) An IP header without options in 20 bytes. An ICMP 
ECHO_REQUEST packet contains an additional 8 bytes worth of ICMP 
header followed by an arbitrary amount of data. When a packetsize is 
given, this indicated the size of this extra blob of data (the default is 56). 
Thus the amount of data received inside of an IP packet of type ICMP 
ECHO_REPLY will always be 8 bytes more than the requested data space 
(the ICMP header). 

If the data space is at least eight bytes large, ping uses the first eight bytes 
of this space to include a timestamp which it uses in the computation of 
round trip times. This explains why if less than eight bytes of pad are 
requested, no round trip times are given. 

BUGS 

Far too many hosts and gateways (including the core gateways) ignore the 
RECORD_ROUTE option. To quote RFC 791, "What is optional is their 
transmission in any particular datagram, not their implementation." 

The maximum IP header length is too small for options like 
RECORD_ROUTE to be completely useful. (There’s not much that can be 
done about that however.) 

Flood pinging the broadcast address is not recommended. 

The record-route option does not work with hosts using network code 
derived from 4.3BSD, such as IRIX. This may be fixed in a future release of 
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IRIX. 

AUTHOR 

Mike Muuss, U.S. Army Ballistic Research Laboratory 
SEE ALSO 

netstat(l), ifconfig(lM) 

ORIGIN 

4.3BSD 
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NAME 

powerdown - stop all processes and halt the system 
SYNOPSIS 

powerdown [ -y I -Y ] 

DESCRIPTION 

This command brings the system to a state where nothing is running so the 
power can be turned off. 

By default, the user is asked questions that control how much warning the 
other users are given. The options: 

-y prevents the questions from being asked and just gives the warning 
messages. There is a 60 second pause between the warning mes- 
sages. 

-Y is the same as -y except it has no pause between messages. It is 
the fastest way to bring the system down. 

The identical function is also available under the sysadm command: 
sysadm powerdown 

Password control can be instituted on this command. See sysadm{ 1), 
admpasswd sub-command. 

EXAMPLES 

some-long-running-command; powerdown -y 

The first command is run to completion and then the system is halted. This 
is useful for, say, formatting a document to the printer at the end of a day. 

FILES 

/etc/shutdown - invoked by powerdown 

SEE ALSO 

shutdown(lM). 

sysadm(l) in the User' s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

preset - reset the lp queue system to a pristine state by deleting printers 
SYNOPSIS 

/usr/spool/lp/etc/util/preset 

DESCRIPTION 

preset should be used when standard methods of manipulating printers 
(adding, deleting) or the lp printing queue fail. For example, rmprinter 
(1M) can fail if any of the standard lp utilities it calls fail, and the utilities 
can fail if certain files are corrupted, preset deletes and creates crucial files 
in the lp spool directory; after it is run, there are no printers and the system 
will allow printers to be added. 

AUTHOR 

Glen Williams 

SEE ALSO 

mknetpr(lM), mkPS(lM), mkcentpr(lM) 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

profiler: prfld, prfstat, prfdc, prfsnap, prfpr - UNIX system profiler 
SYNOPSIS 

/etc/prfld [ system_namelist ] 

/etc/prfstat on 
/etc/prfstat off 

/etc/prfdc file [ period [ off_hour ] ] 

/etc/prfsnap file 

/etc/prfpr file [ cutoff [ system_namelist ] ] 

DESCRIPTION 

Prfld, prfstat, prfdc , prfsnap, and prfpr form a system of programs to facil- 
itate an activity study of the UNIX operating system. 

Prfld is used to initialize the recording mechanism in the system. It gen- 
erates a table containing the starting address of each system subroutine as 
extracted from system jiamelist . 

Prfstat is used to enable or disable the sampling mechanism. Profiler over- 
head is less than 1% as calculated for 500 text addresses. Prfstat will also 
reveal the number of text addresses being measured. 

Prfdc and prfsnap perform the data collection function of the profiler by 
copying the current value of all the text address counters to a file where the 
data can be analyzed. Prfdc will store the counters into file every period 
minutes and will turn off at ojfjiour (valid values for offjiour are 0-24). 
Prfsnap collects data at the time of invocation only, appending the counter 
values to file. 

Prfpr formats the data collected by prfdc or prfsnap. Each text address is 
converted to the nearest text symbol (as found in systemjiamelist ) and is 
printed if the percent activity for that range is greater than cutoff, cutoff 
may be given as a floating-point number >= 0.01. If cutoff is zero, then all 
samples collected are printed, even if their percentage is less than 0.01%. 

FILES 

/dev/prf interface to profile data and text addresses 
/unix default for system namelist file 

ORIGIN 

AT&T V.3 
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NAME 

prtvtoc - print volume header information. 

SYNOPSIS 

/etc/prtvtoc [header device name] device 
DESCRIPTION 

prtvtoc Prints a summary of the information in the volume header of a disk. 
(See vh(7m)). The command can be used only by the super-user. 

The device name should be the raw device filename of a disk volume 
header in the form ldevlrdsklxxs?d?vh. 

Note: prtvtoc knows about the special file directory naming conventions, so 
the Idevlrdsk prefix may be omitted. 

If no name is given, the information for the root disk is printed. 

Prtvtoc prints information about the disk geometry (number of cylinders 
etc.), followed by information about the partitions. For each partition, the 
type is indicated (e.g. filesystem, raw data etc.). For filesystem partitions 
prtvtoc shows if there is actually a filesystem on the partition, and if it is 
mounted, the mount point is shown. 

The following options to prtvtoc may be used: 

-s Print only the partition table, with headings but without the com- 

ments. 

-h Print only the partition table, without headings and comments. 

Use this option when the output of the prtvtoc command is piped 
into another command. 

-tfstab Use the file fstab instead of /etc/fstab. 

-m mnttab 

Use the file mnttab instead of /etc/mount. 
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EXAMPLE 

The output below is for a 180 megabyte root disk, obtained by invoking 
prtvtoc without parameters. 


Printing label for root disk 

* /dev/rdsk/ipsOdOvh (bootfile "/unix") partition map 

* 

* Dimensions: 

* 512 bytes/sector 

* 32 sectors/track 

* 10 tracks/cylinder 

* 823 cylinders 

* 23 cylinders occupied by header & badblock replacement tracks 

* 800 accessible cylinders 

* 

* No space unallocated to partitions 

Partition Type Fs Start: sec (cyl) Size: sec (cyl) Mount Directory 


0 

efs yes 

2240 ( 7) 32640 ( 102) / 

1 

raw 

34880(109) 65600 (205) 

2 

efs yes 

100480(314) 157760 (493) 

5 

efs yes 

100480(314) 157760 (493) 

6 

efs yes 

100480(314) 157760 (493) /usr 

7 

efs 

2240 ( 7) 256000 ( 800) 

8 

volhdr 

0 ( 0) 2240 ( 7) 

9 

trkrepl 

258240(807) 5120 ( 16) 

10 

volume 

0 ( 0) 263360 ( 823) 


SEE ALSO 

dvhtool(lM). fx(lm). vh(7m). 


ORIGIN 

AT&T V.3 
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NAME 

pwck, grpck - password/group file checkers 

SYNOPSIS 

/etc/pwck [file] 

/etc/grpck [file] 

DESCRIPTION 

pwck scans the password file and notes any inconsistencies. The checks 
include validation of the number of fields, login name, user ID, group ID, 
and whether the login directory and the program-to-use-as-Shell exist. The 
default password file is /etc/passwd. 

Grpck verifies all entries in the group file. This verification includes a check 
of the number of fields, group name, group ID, and whether all login names 
appear in the password file. The default group file is /etc/group. 

FILES 

/etc/group 

/etc/passwd 

SEE ALSO 

group(4), passwd(4) in the Programmer' s Reference Manual. 
DIAGNOSTICS 

Group entries in /etc/group with no login names are flagged. 

ORIGIN 

AT&T V.3 
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NAME 

rcO - run commands performed to stop the operating system 

SYNOPSIS 

/etc/rcO 

DESCRIPTION 

This file is executed at each system state change that needs to have the sys- 
tem in an inactive state. It is responsible for those actions that bring the 
system to a quiescent state, traditionally called “shutdown”. 

There are three system states that require this procedure. They are state 0 
(the system halt state), state 5 (the firmware state), and state 6 (the reboot 
state). Whenever a change to one of these states occurs, the letdrcO pro- 
cedure is run. The entry in /etc/inittab might read: 

s0:056:wait:/etc/rc0 >/dev/console 2>&1 </dev/console 

Some of the actions performed by /etc/rcO are carried out by files in the 
directory /etc/shutdown.d. and files beginning with K in /etc/rcO.d. These 
files are executed in ascii order (see FILES below for more information), 
terminating some system service. The combination of commands in 
letdrcO and files in /etc/shutdown.d and /etc/rcO.d determines how the sys- 
tem is shut down. 

The recommended sequence for letdrcO is: 

Stop System Services and Daemons. 

Various system services (such as 3BNET Local Area Network or 
LP Spooler) are gracefully terminated. 

When new services are added that should be terminated when the 
system is shut down, the appropriate files are installed in 
/etc/shutdown.d and /etc/rc0.d. 

Terminate Processes 

SIGTERM signals are sent to all running processes by killall{\M). 
Processes stop themselves cleanly if sent SIGTERM. 

Kill Processes 

SIGKELL signals are sent to all remaining processes; no process 
can resist SIGKILL. 

At this point the only processes left are those associated with 
letdrcO and processes 0 and 1, which are special to the operating 
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system. 

Unmount All File Systems 

Only the root file system (/) remains mounted. 

Depending on which system state the systems end up in (0, 5, or 6), the 
entries in /etc/inittab will direct what happens next. If the /etc/inittab has 
not defined any other actions to be performed as in the case of system state 
0, then the operating system will have nothing to do. It should not be possi- 
ble to get the system’s attention. The only thing that can be done is to turn 
off the power or possibly get the attention of a firmware monitor. The com- 
mand can be used only by the super-user. 

FILES 

The execution by /bin/sh of any files in /etc/shutdown.d occurs in ascii 
sort-sequence order. See rc2(lM) for more information. 

SEE ALSO 

killall(lM), rc2(lM), shutdown(lM). 

ORIGIN 

AT&T V.3 
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NAME 

rc2 - run commands performed for multi-user environment 

SYNOPSIS 

/etc/rc2 

DESCRIPTION 

This file is executed via an entry in /etc/inittab and is responsible for those 
initializations that bring the system to a ready-to-use state, traditionally 
state 2, called the "multi-user" state. 

The actions performed by /etc/rc2 are found in files in the directory 
/etc/rc.d and files beginning with S in /etc/rc2.d. These files are executed 
by /bin/sh in ascii sort-sequence order (see FILES for more information). 
When functions are added that need to be initialized when the system goes 
multi-user, an appropriate file should be added in /etc/rc2.d. 

The functions done by /etc/rc2 command and associated /etc/rc2.d files 
include: 


Setting and exporting the TIMEZONE variable. 

Setting-up and mounting the user (/usr) file system. 

Cleaning up (remaking) the /tmp and /usr/tmp directories. 

Initializing the network interfaces, mounting network file systems, 
and starting the appropriate daemon processes. 

Starting the cron daemon by executing /etc/cron. 

Cleaning up (deleting) uucp locks status, and temporary files in the 
/usr/spool/uucp directory. 

Other functions can be added, as required, to support the addition of 
hardware and software features. 

EXAMPLES 

The following are prototypical files found in /etc/rc2.d. These files are 
prefixed by an S and a number indicating the execution order of the files. 

MOUNTFILESYS 

# Set up and mount file systems 

cd/ 

/etc/mountall /etc/fstab 
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RMTMPFILES 

# clean up /tmp 
rm -rf /tmp 
mkdir /tmp 
chmod 111 /tmp 
chgrp sys /tmp 
chown sys /tmp 

uucp 

# clean-up uucp locks, status, and temporary files 
rm -rf /usr/spool/locks/* 

The file /etc/TIMEZONE is included early in Ietclrc2 , thus establishing the 
default time zone for all commands that follow. 

FILES 

Here are some hints about files in /etc/rc.d: 

The order in which files are executed is important. Since they are executed 
in ascii sort-sequence order, using the first character of the file name as a 
sequence indicator will help keep the proper order. Thus, files starting with 
the following characters would be: 

[0-9]. very early 
[A-Z], early 
[a-n], later 
[o-z], last 

3.mountfs 

Files in /etc/rc.d that begin with a dot (.) will not be executed. This feature 
can be used to hide files that are not to be executed for the time being 
without removing them. The command can be used only by the super-user. 

Files in /etc/rc2.d must begin with an S or a K followed by a number and 
the rest of the file name. Upon entering run level 2, files beginning with S 
are executed with the start option; files beginning with K, are executed 
with the stop option. Files beginning with other characters are ignored. 

SEE ALSO 

shutdown(lM). 

ORIGIN 

AT&T V.3 
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NAME 

reboot - reboot the system 

SYNOPSIS 

cd /; /etc/reboot 

DESCRIPTION 

When UNIX is running reboot halts and then restarts the system in an ord- 
erly fashion. It is useful after changing the configuration of the system. To 
halt the system before turning it off, use shutdown or halt. 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

rexecd - remote execution server 

SYNOPSIS 

/usr/etc/rexecd 

DESCRIPTION 

Rexecd is the server for the rexec (3N) routine. The server provides remote 
execution facilities with authentication based on user names and passwords. 

Rexecd listens for service requests at the port indicated in the “exec” ser- 
vice specification; see servicesiA). When a service request is received the 
following protocol is initiated: 

1) The server reads characters from the socket up to a null (‘NO’) byte. 
The resultant string is interpreted as an ASCII number, base 10. 

2) If the number received in step 1 is non-zero, it is interpreted as the 
port number of a secondary stream to be used for the stderr. A 
second connection is then created to the specified port on the 
client’s machine. 

3) A null-terminated user name of at most 16 characters is retrieved 
on the initial socket. 

4) A null-terminated, unencrypted password of at most 16 characters 
is retrieved on the initial socket. 

5) A null-terminated command to be passed to a shell is retrieved on 
the initial socket. The length of the command is limited by the 
upper bound on the size of the system’s argument list. 

6) Rexecd then validates the user as is done at login time and, if the 
authentication was successful, changes to the user’s home direc- 
tory, and establishes the user and group protections of the user. If 
any of these steps fail the connection is aborted with a diagnostic 
message returned. 

7) A null byte is returned on the initial socket and the command line 
is passed to the normal login shell of the user. The shell inherits 
the network connections established by rexecd. 

DIAGNOSTICS 

Except for the last one listed below, all diagnostic messages are returned on 
the initial socket, after which any network connections are closed. An error 
is indicated by a leading byte with a value of 1 (0 is returned in step 7 above 
upon successful completion of all the steps prior to the command execu- 
tion). 

“username too long” 

The name is longer than 16 characters. 
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“password too long” 

The password is longer than 16 characters. 

“command too long ” 

The command line passed exceeds the size of the argument list (as 
configured into the system). 

“Login incorrect.” 

No password file entry for the user name existed. 

“Password incorrect.” 

The wrong was password supplied. 

“No remote directory.” 

The chdir command to the home directory failed. 

“Try again.” 

A fork by the server failed. 

“<shellname>: ...” 

The user’s login shell could not be started. This message is returned on the 
connection associated with the stderr, and is not preceded by a flag byte. 

SEE ALSO 

rexec(3N) 

BUGS 

Indicating “Login incorrect” as opposed to “Password incorrect” is a 
security breach which allows people to probe a system for users with null 
passwords. 

A facility to allow all data and password exchanges to be encrypted should 
be present. 

ORIGIN 

4.3BSD 
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NAME 

rlogind - remote login server 

SYNOPSIS 

/usr/etc/rlogind 

DESCRIPTION 

Rlogind is the server for the rlogin( 1C) program. The server provides a 
remote login facility with authentication based on privileged port numbers 
from trusted hosts. 

Rlogind listens for service requests at the port indicated in the “login” ser- 
vice specification; see services (4). When a service request is received the 
following protocol is initiated: 

1) The server checks the client’s source port. If the port is not in the 
range 513-1023, the server aborts the connection. 

2) The server checks the client’s source address and requests the 
corresponding host name (see gethostbyaddr( 3N), hosts( 4) and 
named( 1M)). If the hostname cannot be determined, the dot- 
notation representation of the host address is used. 

Once the source port and address have been checked, rlogind allocates a 
pseudo terminal (see pty(lM)), and manipulates file descriptors so that the 
slave half of the pseudo terminal becomes the stdin , stdout , and stderr 
for a login process. The login process is an instance of the login{ 1) pro- 
gram, invoked with the -r option. The login process then proceeds with the 
authentication process as described in rshd( 1M), but if automatic authenti- 
cation fails, it reprompts the user to login as one finds on a standard termi- 
nal line. 

The parent of the login process manipulates the master side of the pseduo 
terminal, operating as an intermediary between the login process and the 
client instance of the rlogin program. In normal operation, the packet pro- 
tocol described in pty( 7M) is invoked to provide ~SfQ type facilities and 
propagate interrupt signals to the remote programs. The login process pro- 
pagates the client terminal’s baud rate and terminal type, as found in the 
environment variable, “TERM”; see environ (5). 

DIAGNOSTICS 

All diagnostic messages are returned on the connection associated with the 
stderr, after which any network connections are closed. An error is indi- 
cated by a leading byte with a value of 1 . 

“Try again.” 

A fork by the server failed. 
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“/bin/sh: ...” 

The user’s login shell could not be started. 

BUGS 

The authentication procedure used here assumes the integrity of each client 
machine and the connecting medium. This is insecure, but is useful in an 
“open” environment. 

A facility to allow all data exchanges to be encrypted should be present. 

A more extensible protocol should be used. 

ORIGIN 

4.3BSD 
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NAME 

rmail - receive mail via UUCP 
SYNOPSIS 

rmail [ -T ] destination 
DESCRIPTION 

Rmail combines the 'From ... remove from ...’ lines that UUCP addes to the 
beginning of mail messages into a single From line. It passes the result to 
sendmail (IM). 

Rmail is intended to be executed by uux. It is not intended to be used any- 
thing else. 

The -T flag is used for debugging, and logs the command used to start 
sendmail in the system log. 

SEE ALSO 

mail_att(l), mail_bsd(l), sendmail(lM), syslog(lB), uux(lC) 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

rmprinter - remove a printer from the LP spooling system 
SYNOPSIS 

/usr/spool/lp/etc/util/rmprinter printer 
DESCRIPTION 

rmprinter performs tasks that undo the actions of mkPS, mkcentpr, and 
mknetpr. It removes the interface file, the log file, and calls various 
lpadmin( 1M) functions to remove references to the printer in the spooler. 

FILES 

/usr/spool/lp/etc/log/<printer>-log/usr/spool/lp/interface/<printer> 

SEE ALSO 

Ipshut(lM), lp(l), lpadmin(lM), lpsched(lM), Ipshut(lM), lpstat(l), 
mkcentpr, mknetpr, mkPS. 

AUTHOR 

Glen Williams 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

rmt - remote magtape protocol module 

SYNOPSIS 

/etc/rmt 

DESCRIPTION 

Rmt is a program used by the remote dump and restore programs in manipu- 
lating a magnetic tape drive through an interprocess communication con- 
nection. Rmt is normally started up with an rexec( 3N) or rcmd(2N) call. 

The rmt program accepts requests specific to the manipulation of magnetic 
tapes, performs the commands, then responds with a status indication. All 
responses are in ASCII and in one of two forms. Successful commands 
have responses of 

Knumhervn 

where number is an ASCII representation of a decimal number. Unsuccess- 
ful commands are responded to with 

Eerror-number\nerror-message\n y 

where error-number is one of the possible error numbers described in 
intro (2) and error-message is the corresponding error string as printed from 
a call to perror( 3). The protocol is comprised of the following commands 
(a space is present between each token). 

O device mode Open the specified device using the indicated mode . 

Device is a full pathname and mode is an ASCII 
representation of a decimal number suitable for passing 
to open (2). If a device had already been opened, it is 
closed before a new open is performed. 

C device Close the currently open device. The device specified is 

ignored. 

L whence offset Perform an lseek(2) operation using the specified param- 
eters. The response value is that returned from the Iseek 
call. 

W count Write data onto the open device. Rmt reads count bytes 

from the connection, aborting if a premature end-of-file 
is encountered. The response value is that returned from 
the write( 2) call. 

R count Read count bytes of data from the open device. If count 

exceeds the size of the data buffer (10 kilobytes), it is 
truncated to the data buffer size. Rmt then performs the 
requested read( 2) and responds with \count-readsn if 
the read was successful; otherwise an error in the 
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standard format is returned. If the read was successful, 
the data read is then sent. 

I operation count 

Perform a MTIOCOP ioctl( 2) command using the 
specified parameters. The parameters are interpreted as 
the ASCII representations of the decimal values to place 
in the mt_op and mt_count fields of the structure used in 
the ioctl call. The return value is the count parameter 
when the operation is successful. 

S Return the status of the open device, as obtained with a 

MTIOCGET ioctl call. If the operation was successful, 
an “ack” is sent with the size of the status buffer, then 
the status buffer is sent (in binary). 

Any other command causes rmt to exit. 

DIAGNOSTICS 

All responses are of the form described above. 

SEE ALSO 

rcmd(3N), rexec(3N), mtio(7), 

BUGS 

People tempted to use this for a remote file access protocol are discouraged. 

ORIGIN 

4.3BSD 
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NAME 

route - manually manipulate the routing tables 
SYNOPSIS 

/usr/etc/route [ -f ] [ -n ] [ command args ] 

DESCRIPTION 

Route is a program used to manually manipulate the network routing tables. 
It normally is not needed, as the system routing table management daemon, 
route d(\M), should tend to this task. 

Route accepts two commands: add, to add a route, and delete, to delete a 
route. 

All commands have the following syntax: 

/usr/etc/route command [ net I host ] destination gateway [ metric ] 

where destination is the destination host or network, gateway is the next- 
hop gateway to which packets should be addressed, and metric is a count 
indicating the number of hops to the destination. The metric is required for 
add commands; it must be zero if the destination is on a directly-attached 
network, and nonzero if the route utilizes one or more gateways. If adding 
a route with metric 0, the gateway given is the address of this host on the 
common network, indicating the interface to be used for transmission. 
Routes to a particular host are distinguished from those to a network by 
interpreting the Internet address associated with destination. The optional 
keywords net and host force the destination to be interpreted as a network 
or a host, respectively. Otherwise, if the destination has a “local address 
part” of INADDR_ANY, or if the destination is the symbolic name of a 
network, then the route is assumed to be to a network; otherwise, it is 
presumed to be a route to a host. If the route is to a destination connected 
via a gateway, the metric should be greater than 0. All symbolic names 
specified for a destination or gateway are looked up first as a host name 
using gethostbynameON). If this lookup fails, getnetbyname (3N) is then 
used to interpret the name as that of a network. 

Route uses a raw socket and the SIOCADDRT and SIOCDELRT ioctV s to 
do its work. As such, only the super-user may modify the routing tables. 

If the -f option is specified, route will “flush” the routing tables of all gate- 
way entries. If this is used in conjunction with one of the commands 
described above, the tables are flushed prior to the command’s application. 

The -n option prevents attempts to print host and network names symboli- 
cally when reporting actions. 

DIAGNOSTICS 

“add [ host | network ] %s: gateway %s flags %x” 

The specified route is being added to the tables. The values printed are 
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from the routing table entry supplied in the ioctl call. If the gateway 
address used was not the primary address of the gateway (the first one 
returned by gethostbyname), the gateway address is printed numerically as 
well as symbolically. 

“delete [ host | network ] %s: gateway %s flags %x” 

As above, but when deleting an entry. 

“%s %s done” 

When the -f flag is specified, each routing table entry deleted is indicated 
with a message of this form. 

“Network is unreachable” 

An attempt to add a route failed because the gateway fisted was not on a 
directly-connected network. The next-hop gateway must be given. 

“not in table” 

A delete operation was attempted for an entry which wasn’t present in the 
tables. 

“routing table overflow” 

An add operation was attempted, but the system was low on resources and 
was unable to allocate memory to create the new entry. 

SEE ALSO 

routed(lM) 

ORIGIN 

4.3BSD 
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NAME 

routed - network routing daemon 
SYNOPSIS 

/usr/etc/routed [ -d ] [ -g ] [ -s ] [ -q ] [ -t ] [ logfile ] 
DESCRIPTION 

Routed is invoked at boot time to manage the network routing tables. The 
routing daemon uses a variant of the Xerox NS Routing Information Proto- 
col in maintaining up to date kernel routing table entries. It used a general- 
ized protocol capable of use with multiple address types, but is currently 
used only for Internet routing within a cluster of networks. 

In normal operation routed listens on the udp(lP) socket for the route ser- 
vice (see services ( 4)) for routing information packets. If the host is an 
internetwork router, it periodically supplies copies of its routing tables to 
any directly connected hosts and networks. 

When routed is started, it uses the SIOCGIFCONF ioctl to find those 
directly connected interfaces configured into the system and marked “up” 
(the software loopback interface is ignored). If multiple interfaces are 
present, it is assumed that the host will forward packets between networks. 
Routed then transmits a request packet on each interface (using a broadcast 
packet if the interface supports it) and enters a loop, listening for request 
and response packets from other hosts. 

When a request packet is received, routed formulates a reply based on the 
information maintained in its internal tables. The response packet gen- 
erated contains a list of known routes, each marked with a “hop count” 
metric (a count of 16, or greater, is considered “infinite”). The metric 
associated with each route returned provides a metric relative to the sender. 

Response packets received by routed are used to update the routing tables if 
one of the following conditions is satisfied: 

(1) No routing table entry exists for the destination network or host, 
and the metric indicates the destination is “reachable” (i.e. the 
hop count is not infinite). 

(2) The source host of the packet is the same as the router in the exist- 
ing routing table entry. That is, updated information is being 
received from the very internetwork router through which packets 
for the destination are being routed. 

(3) The existing entry in the routing table has not been updated for 
some time (defined to be 90 seconds) and the route is at least as 
cost effective as the current route. 
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(4) The new route describes a shorter route to the destination than the 
one currently stored in the routing tables; the metric of the new 
route is compared against the one stored in the table to decide this. 

When an update is applied, routed records the change in its internal tables 
and updates the kernel routing table. The change is reflected in the next 
response packet sent. 

In addition to processing incoming packets, routed also periodically checks 
the routing table entries. If an entry has not been updated for 3 minutes, the 
entry’s metric is set to infinity and marked for deletion. Deletions are 
delayed an additional 60 seconds to insure the invalidation is propagated 
throughout the local internet. 

Hosts acting as internetwork routers gratuitously supply their routing tables 
every 30 seconds to all directly connected hosts and networks. The 
response is sent to the broadcast address on nets capable of that function, to 
the destination address on point-to-point links, and to the router’s own 
address on other networks. The normal routing tables are bypassed when 
sending gratuitous responses. The reception of responses on each network 
is used to determine that the network and interface are functioning 
correctly. If no response is received on an interface, another route may be 
chosen to route around the interface, or the route may be dropped if no 
alternative is available. 

Routed supports several options: 

-d Enable additional debugging information to be logged, such as bad 
packets received. 

-g This flag is used on internetwork routers to offer a route to the 
* ‘default’ ’ destination. This is typically used on a gateway to the 
Internet, or on a gateway that uses another routing protocol whose 
routes are not reported to other local routers. 

-s Supplying this option forces routed to supply routing information 
whether it is acting as an internetwork router or not. This is the 
default if multiple network interfaces are present, or if a point-to- 
point link is in use. 

-q This is the opposite of the -s option. 

-t If the -t option is specified, all packets sent or received are printed 
on the standard output. In addition, routed will not divorce itself 
from the controlling terminal so that interrupts from the keyboard 
will kill the process. 

Any other argument supplied is interpreted as the name of file in which 
routed ’s actions should be logged. This log contains information about any 
changes to the routing tables and, if not tracing all packets, a history of 
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recent messages sent and received which are related to the changed route. 

In addition to the facilities described above, routed supports the notion of 
“distant” passive and active gateways. When routed is started up, it reads 
the file /etc/ gateways to find gateways which may not be located using only 
information from the SIOGIFCONF ioctl. Gateways specified in this 
manner should be marked passive if they are not expected to exchange rout- 
ing information, while gateways marked active should be willing to 
exchange routing information (i.e. they should have a routed process run- 
ning on the machine). Passive gateways are maintained in the routing 
tables forever and information regarding their existence is included in any 
routing information transmitted. Active gateways are treated equally to net- 
work interfaces. Routing information is distributed to the gateway and if no 
routing information is received for a period of the time, the associated route 
is deleted. External gateways are also passive, but are not placed in the ker- 
nel routing table nor are they included in routing updates. The function of 
external entries is to inform routed that another routing process will install 
such a route, and that alternate routes to that destination should not be 
installed. Such entries are only required when both routers may learn of 
routes to the same destination. 

The /etc/ gateways is comprised of a series of lines, each in the following 
format: 

< net I host > namel gateway name2 metric value < passive I active I external > 

The net or host keyword indicates if the route is to a network or specific 
host. 

Namel is the name of the destination network or host. This may be a sym- 
bolic name located in /etc/networks or letc/hosts or an Internet address 
specified in “dot” notation; see inet( 3N). 

Name2 is the name or address of the gateway to which messages should be 
forwarded. 

Value is a metric indicating the hop count to the destination host or net- 
work. 

One of the keywords passive, active or external indicates if the gateway 
should be treated as passive or active (as described above), or whether the 
gateway is external to the scope of the routed protocol. 

Internetwork routers that are directly attached to the Arpanet or Milnet 
should use the Exterior Gateway Protocol (EGP) to gather routing informa- 
tion rather then using a static routing table of passive gateways. EGP is 
required in order to provide routes for local networks to the rest of the Inter- 
net system. Sites needing assistance with such configurations should con- 
tact SGI. 
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FILES 

/etc/gateways for distant gateways 
SEE ALSO 

“Internet Transport Protocols”, XSIS 028112, Xerox System Integration 

Standard. 

udp(7P) 

BUGS 

The kernel’s routing tables may not correspond to those of routed when 
redirects change or add routes. The only remedy for this is to place the 
routing process in the kernel. 

Routed should incorporate other routing protocols, such as Xerox NS and 
EGP. Using separate processes for each requires configuration options to 
avoid redundant or competing routes. 

Routed should listen to intelligent interfaces, such as an IMP, and to error 
protocols, such as ICMP, to gather more information. It does not always 
detect unidirectional failures in network interfaces (e.g., when the output 
side fails). 

ORIGIN 

4.3BSD 


Version 3.0 
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NAME 

rshd - remote shell server 

SYNOPSIS 

/usr/etc/rshd 

DESCRIPTION 

Rshd is the server for the rcmd (3N) routine and, consequendy, for the 
rsh{ 1C) program. The server provides remote execution facilities with 
authentication based on privileged port numbers from trusted hosts. 

Rshd listens for service requests at the port indicated in the “cmd” service 
specification; see services (4). When a service request is received the fol- 
lowing protocol is initiated: 

1) The server checks the client’s source port. If the port is not in the 
range 513-1023, the server aborts the connection. 

2) The server reads characters from the socket up to a null (‘\0’) byte. 
The resultant string is interpreted as an ASCII number, base 10. 

3) If the number received in step 1 is non-zero, it is interpreted as the 
port number of a secondary stream to be used for the stderr. A 
second connection is then created to the specified port on the 
client’s machine. The source port of this second connection is also 
in the range 0-1023. 

4) The server checks the client’s source address and requests the 
corresponding host name (see gethostbyaddr( 3N), hosts(4) and 
named (IM)). If the hostname cannot be determined, the dot- 
notation representation of the host address is used. 

5) A null terminated user name of at most 16 characters is retrieved 
on the initial socket. This user name is interpreted as the user 
identity on the client’s machine. 

6) A null terminated user name of at most 16 characters is retrieved 
on the initial socket. This user name is interpreted as a user iden- 
tity to use on the server’s machine. 

7) A null terminated command to be passed to a shell is retrieved on 
the initial socket. The length of the command is limited by the 
upper bound on the size of the system’s argument list. 
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8) Rshd then validates the user according to the following steps. The 
local (server-end) user name is looked up in the password file and 
a chdir is performed to the user’s home directory. If either the 
lookup or chdir fail, the connection is terminated. If the user is not 
the super-user, (user id 0), the file letcl hosts. equiv is consulted for 
a list of hosts considered “equivalent”. If the client’s host name 
is present in this file, the authentication is considered successful. 
If the lookup fails, or the user is the super-user, then the file .rhosts 
in the home directory of the remote user is checked for the 
machine name and identity of the user on the client’s machine. If 
this lookup fails, the connection is terminated. 

9) A null byte is returned on the initial socket and the command line 
is passed to the normal login shell of the user. The shell inherits 
the network connections established by rshd. 

DIAGNOSTICS 

Except for the last one listed below, all diagnostic messages are returned on 
the initial socket, after which any network connections are closed. An error 
is indicated by a leading byte with a value of 1 (0 is returned in step 9 above 
upon successful completion of all the steps prior to the execution of the 
login shell). 

“locuser too long” 

The name of the user on the client’s machine is longer than 16 characters, 
“remuser too long” 

The name of the user on the remote machine is longer than 16 characters, 
“command too long ” 

The command line passed exceeds the size of the argument list (as 
configured into the system). 

“Login incorrect.” 

No password file entry for the user name existed. 

“No remote directory.” 

The chdir command to the home directory failed. 

“Permission denied.” 

The authentication procedure described above failed. 

“Can’t make pipe.” 

The pipe needed for the stderr, wasn’t created. 

“Try again.” 

A fork by the server failed. 

“<shellname>: ...” 

The user’s login shell could not be started. This message is returned on the 
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connection associated with the stderr, and is not preceded by a flag byte. 

SEE ALSO 

rsh(lC), rcmd(3N) 

BUGS 

The authentication procedure used here assumes the integrity of each client 
machine and the connecting medium. This is insecure, but is useful in an 
“open” environment. 

A facility to allow all data exchanges to be encrypted should be present. 

A more extensible protocol should be used. 

ORIGIN 

4.3BSD 


September 1988 


-3- 


Version 3.0 



RUNACCT(IM) 


Silicon Graphics 


RUNACCT(IM) 


NAME 

runacct - ran daily accounting 
SYNOPSIS 

/usr/lib/acct/runacct [mmdd [state]] 

DESCRIPTION 

runacct is the main daily accounting shell procedure. It is normally ini- 
tiated via cran(lM). runacct processes connect, fee, disk, and process 
accounting files. It also prepares summary files for prdaily or billing pur- 
poses. runacct is distributed only to source code licensees. 

runacct takes care not to damage active accounting files or summary files in 
the event of errors. It records its progress by writing descriptive diagnostic 
messages into active. When an error is detected, a message is written to 
/dev/console, mail (see mail( 1)) is sent to root and adm, and runacct ter- 
minates. runacct uses a series of lock files to protect against re-invocation. 
The files lock and lockl are used to prevent simultaneous invocation, and 
lastdate is used to prevent more than one invocation per day. 

runacct breaks its processing into separate, restartable states using statefile 
to remember the last state completed. It accomplishes this by writing the 
state name into statefile. runacct then looks in statefile to see what it has 
done and to determine what to process next, states are executed in the fol- 
lowing order: 

SETUP Move active accounting files into working files. 

WTMPFIX Verify integrity of wtmp file, correcting date 
changes if necessary. 

CONNECT1 Produce connect session records in ctmp.h format. 

CONNECT2 Convert ctmp.h records into tacct.h format. 

PROCESS Convert process accounting records into tacct.h 
format. 

MERGE Merge the connect and process accounting 

records. 

FEES Convert output of chargefee into tacct.h format 

and merge with connect and process accounting 
records. 

DISK Merge disk accounting records with connect, pro- 

cess, and fee accounting records. 

MERGETACCT 

Merge the daily total accounting records in day- 
tacct with the summary total accounting records in 
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lusrladmlacctlsumltacct. 

CMS Produce command summaries. 

USEREXIT Any installation-dependent accounting programs 

can be included here. 

CLEANUP Cleanup temporary files and exit. 

To restart runacct after a failure, first check the active file for diagnostics, 
then fix up any corrupted data files such as pacct or wtmp. The lock files 
and lastdate file must be removed before runacct can be restarted. The 
argument mmdd is necessary if runacct is being restarted, and specifies the 
month and day for which runacct will rerun the accounting. Entry point for 
processing is based on the contents of statefile ; to override this, include the 
desired state on the command line to designate where processing should 
begin. 

EXAMPLES 

To start runacct. 

nohup runacct 2> /usr/adm/acct/nite/fd2Iog & 

To restart runacct. 

nohup runacct 0601 2» /usr/adm/acct/nite/fd21og & 

To restart runacct at a specific state. 

nohup runacct 0601 MERGE 2» /usr/adm/acct/nite/fd21og & 

FILES 

/etc/wtmp 

/usr/adm/pacct* 

/usr/src/cmd/acct/tacct.h 

/usr/src/cmd/acct/ctmp.h 

/usr/adm/acct/nite/active 

/usr/adm/acct/nite/daytacct 

/usr/adm/acct/nite/lock 

/usr/adm/acct/nitc/lock 1 

/usr/adm/acct/nite/lastdate 

/usr/adm/acct/nite/statefile 

/usr/adm/acct/nite/ptacct* .mmdd 

SEE ALSO 

acct(lM), acctcms(lM), acctcon(lM), acctmerg(lM), acctprc(lM), 

acctsh(lM), cron(lM), fwtmp(lM) 

acctcom(l), mail(l) in the U ser' s Reference Manual 

acct(2), acct(4), utmp(4) in the Programmer’ s Reference Manual 

BUGS 

Normally it is not a good idea to restart runacct in the SETUP state. Run 
SETUP manually and restart via: 
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runacct mmdd WTMPFIX 

If runacct failed in the PROCESS state, remove the last ptacct file because 
it will not be complete. 

ORIGIN 

AT&T V.3.1 
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NAME 

rwhod - system status server 

SYNOPSIS 

/usr/etc/rwhod 

DESCRIPTION 

Rwhod is the server which maintains the database used by the rwho{\C) 
and ruptime{ 1C) programs. Its operation is predicated on the ability to 
broadcast messages on a network. 

Rwhod operates as both a producer and consumer of status information. As 
a producer of information it periodically queries the state of the system and 
constructs status messages which are broadcast on a network. As a consu- 
mer of information, it listens for other rwhod servers’ status messages, vali- 
dating them, then recording them in a collection of files located in the direc- 
tory lusrl spool! rwho. 

The server transmits and receives messages at the port indicated in the 
“rwho” service specification; see services (4). The messages sent and 
received, are defined in <protocols/rwhod.h>: 


struct outmp { 

char 

out_line[8]; 

/* tty name */ 

char 

out_name[8]; 

1 * user id */ 

long 

}; 

out_time; 

/* time on */ 

struct whod { 

char 

wd_vers; 

/* protocol version # */ 

char 

wd_type; 

/* packet type: WHODT YPE_ST ATU S */ 

char 

wd_pad[2]; 


int 

wd_sendtime; 

/* time stamp by sender */ 

int 

wd_recvtime; 

/* time stamp applied by receiver */ 

char 

wd_hostname[32] ; 

/* hosts’s name */ 

int 

wd_loadav[3]; 

/* load average as in uptime */ 

int 

wd_boottime; 

/* time system booted */ 

struct 

whoent { 



struct outmp we_utmp; 

/* active tty info */ 


int we_idle; 

/* tty idle time */ 


} wd_we[1024 / sizeof (struct whoent)]; 

}; 

All fields are converted to network byte order prior to transmission. The 
load averages represent smoothed CPU loads over the 5, 10, and 15 minute 
intervals prior to a server’s transmission; they are multiplied by 100 for 
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representation in an integer. 

The host name included is that returned by the gethostname{ 2) system call, 
with any trailing domain name omitted. The array at the end of the message 
contains information about the users logged in to the sending machine. 
This information includes the contents of the utmp{ 4) entry for each non- 
idle terminal line and a value indicating the time in seconds since a charac- 
ter was last received on the terminal line. 

Messages received by the rwho server are discarded unless they originated 
at an rwho server’s port. In addition, if the host’s name, as specified in the 
message, contains any unprintable ASCII characters, the message is dis- 
carded. Valid messages received by rwhod are placed in files named 
whod. hostname in the directory I usrl spool! rwho. These files contain only 
the most recent message, in the format described above. 

Status messages are generated approximately once every 3 minutes. Rwhod 
performs an nils t (3) on /unix every 30 minutes to guard against the possibil- 
ity that this file is not the system image currently operating. 

SEE ALSO 

rwho(lC), ruptime(lC) 

BUGS 

There should be a way to relay status information between networks. Status 
information should be sent only upon request rather than continuously. 
People often interpret the server dying or network communication failures 
as a machine going down. 

ORIGIN 

4.3BSD 
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NAME 

sadp - disk access profiler 
SYNOPSIS 

sadp [ -th ] [ -d device[ -drive] ] s [ n ] 

DESCRIPTION 

sadp reports disk access location and seek distance, in tabular or histogram 
form. It samples disk activity once every second during an interval of s 
seconds. This is done repeatedly if n is specified. Cylinder usage and disk 
distance are recorded in units of 8 cylinders. 

Valid values of device are dkip for integral disk or SCSI disk. Drive 
specifies the disk drives and it may be: 

a drive number in the range supported by device , 
two numbers separated by a minus (indicating an inclusive range), 
or 

a list of drive numbers separated by commas. 

Up to 8 disk drives may be reported. The -d option may be omitted, if only 
one device is present. 

The -t flag causes the data to be reported in tabular form. The -h flag pro- 
duces a histogram on the printer of the data. Default is -t. 

EXAMPLE 

The command: 

sadp -d dkip -0 900 4 

will generate 4 tabular reports, each describing cylinder usage and seek dis- 
tance of dkip disk drive 0 during a 15-minute interval. 

FILES 

/dev/kmem 

SEE ALSO 

mem(7). 

ORIGIN 

AT&T V.3 
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NAME 

sar: sal, sa2, sadc - system activity report package 
SYNOPSIS 

/usr/lib/sa/sadc [t n] [ofile] 

/usr/lib/sa/sal [t n] 

/usr/lib/sa/sa2 [-ubdycwaqvmprtgA] [-s time] [-e time] [-i sec] 
DESCRIPTION 

System activity data can be accessed at the special request of a user (see 
sar(l)) and automatically on a routine basis as described here. The 
operating system contains a number of counters that are incremented as 
various system actions occur. These include counters for CPU utilization, 
buffer usage, disk and tape I/O activity, TTY device activity, switching and 
system-call activity, file-access, queue activity, inter-process 
communications, paging and Remote File Sharing. 

Sadc and shell procedures, sal and sa2, are used to sample, save, and 
process this data. 

Sadc, the data collector, samples system data n times every t seconds and 
writes in binary format to ofile or to standard output. If t and n are omitted, 
a special record is written. This facility is used at system boot time, when 
booting to a multiuser state, to mark the time at which the counters restart 
from zero. For example, the /etc/init.d/perf file writes the restart mark to 
the daily data by the command entry: 

su sys -c "/usr/lib/sa/sadc /usr/adm/sa/sa- date +%d - " 

The shell script sal , a variant of sadc, is used to collect and store data in 
binary file /usr/adm/sa/sa^ where dd is the current day. The arguments t 
and n cause records to be written n times at an interval of t seconds, or once 
if omitted. The entries in /usr/spool/cron/crontabs/sys (see cron (1M)): 

0 * * * 0-6 /usr/lib/sa/sal 
20,40 8-17 * * 1-5 /usr/lib/sa/sal 

will produce records every 20 minutes during working hours and hourly 
otherwise. 

The shell script sa2, a variant of sar(Y), writes a daily report in file 
/usr/adm/sa/san/d. The options are explained in sar(l). The 
/usr/spool/cron/crontabs/sys entry: 

5 18 * * 1-5 /usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 1200 -A 
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will report important activities hourly during the working day. 

The structure of the binary daily data file is: 
struct sa { 

struct sysinfo si; /* see /usr/include/sys/sysinfo.h */ 

struct minfo mi; /* defined in sys/sysinfo.h */ 

struck dinfo di; /* RFS info defined in sys/sysinfo.h */ 

int minserve, maxserve; /* RFS server low and high water marks */ 

int szinode; /* current size of inode table */ 

int szfile; /* current size of file table */ 

int szproc; /* current size of proc table */ 

int szlckf; /* current size of file record header table */ 

int szlckr; /* current size of file record lock table */ 

int mszinode; /* size of inode table */ 

int mszfile; /* size of file table */ 

int mszproc; /* size of proc table */ 

int mszlckf; /* maximum size of file record header table */ 

int mszlckr; /* maximum size of file record lock table */ 

long inodeovf; /* cumulative overflows of inode table */ 

long fileovf; /* cumulative overflows of file table */ 

long procovf; /* cumulative overflows of proc table */ 

time_t ts; /* time stamp, seconds */ 

long devio[NDEVS][4]; /* device unit information */ 

#define IO_OPS 0 /* cumulative I/O requests */ 

#define IO_BCNT 1 /* cumulative blocks transferred */ 

#define IO_ACT 2 /* cumulative drive busy time in ticks */ 

#define IO_RESP 3 /* cumulative I/O resp time in ticks */ 

}; 

FILES 

/usr/adm/sa/sarW daily data file 

/usr/adm/sa/sardd daily report file 

/tmp/sa.adrfl address file 

SEE ALSO 

cron(lM). 

sar(l), timex(l) in the U ser’ s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

savecore - save a core dump of the operating system 
SYNOPSIS 

/etc/savecore [ -f ] [ -v ] dir name [ system ] 

DESCRIPTION 

Savecore is meant to be called by /etc/rc2.d/S48savecore. Its function is to 
save the core dump of the system (assuming one was made) and to write a 
reboot message in the shutdown log. 

Savecore saves the core image in the file dirname/v mcore.n and its brother, 
the namelist, dirname/ unix.n The trailing ".n" in the pathnames is replaced 
by a number which grows every time savecore is run in that directory. 

Before savecore writes out a core image, it reads a number from the file 
dirname/ minffee. If the number of free kilobytes on the filesystem which 
contains dirname is less than the number obtained from the minfree file, the 
core dump is not saved. If the minfree file does not exist, savecore always 
writes out the core file (assuming that a core dump was taken). 

Savecore also logs a reboot message using facility LOG_AUTH (see 
syslog( 3B)) If the system crashed as a result of a panic, savecore logs the 
panic string too. 

Savecore assumes that /unix corresponds to the running system at the time 
of the crash. If the core dump was from a system other than /unix, the name 
of that system must be supplied as system. 

The following options apply to savecore: 

-f Ordinarily, savecore checks a magic number on the dump device 
(usually Idevlswap ) to determine if a core dump was made. This 
flag will force savecore to attempt to save the core image regard- 
less of the state of this magic number. This may be necessary 
since savecore will always clear the magic number after reading it. 
If a previous attempt to save the image failed in some manner, it 
will still be possible to restart the save with this option. 

-v Give more verbose output. 

DIAGNOSTICS 

"warning: /unix may not have created core file" is output if savecore 
believes that the system core file does not correspond with the /unix operat- 
ing system binary. 

FILES 

/unix current UNIX 

ORIGIN 

4.3BSD 
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NAME 

sendmail - send mail over the internet 
SYNOPSIS 

/usr/lib/sendmail [ flags ] [ address ... ] 
newaliases 
mailq 
DESCRIPTION 

sendmail sends a message to one or more people, routing the message over 
whatever networks are necessary, sendmail does internetwork forwarding 
as necessary to deliver the message to the correct place. 

sendmail is not intended as a user interface routine; other programs provide 
user-friendly front ends; sendmail is used only to deliver pre-formatted 
messages. 

With no flags, sendmail reads its standard input up to a control-D or a line 
with a single dot and sends a copy of the letter found there to all of the 
addresses listed. It determines the network to use based on the syntax and 
contents of the addresses. 

Local addresses are looked up in a file and aliased appropriately. Aliasing 
can be prevented by preceding the address with a backslash. Normally the 
sender is not included in any alias expansions, e.g., if ‘john’ sends to 
‘group’, and ‘group’ includes ‘john’ in the expansion, then the letter will 
not be delivered to ‘john’. 

Flags are: 

-ba Go into ARPANET mode. All input lines must end with a CR-LF, and 
all messages will be generated with a CR-LF at the end. Also, the 
“From:” and “Sender:” fields are examined for the name of the 
sender. 

— bd Run as a daemon. This requires Berkeley IPC. 

-bi Initialize the alias database. 

-bm Deliver mail in the usual way (default). 

-bp Print a listing of the queue. 

-bs Use the SMTP protocol as described in RFC821. This flag implies all 
the operations of the -ba flag that are compatible with SMTP. 

-bt Run in address test mode. This mode reads addresses and shows the 
steps in parsing; it is used for debugging configuration tables. 

-bv Verify names only - do not try to collect or deliver a message. Ver- 
ify mode is normally used for validating users or mailing lists. 
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-bz Create the configuration freeze file. 

-C file 

Use alternate configuration file. 

-dX Set debugging value to X. 

—Ffullname 

Set the full name of the sender. 

— f name 

Sets the name of the “from” person (i.e., the sender of the mail), -f 
can only be used by the special users root, daemon, and network, or if 
the person you are trying to become is the same as the person you are. 

-h N Set the hop count to N. The hop count is incremented every time the 
mail is processed. When it reaches a limit, the mail is returned with 
an error message, the victim of an aliasing loop. 

-n Don’t do aliasing. 

-o x value 

Set option x to the specified value. Options are described below. 

-q [time] 

Processed saved messages in the queue at given intervals. If time is 
omitted, process the queue once. Time is given as a tagged number, 
with ‘s’ being seconds, ‘m’ being minutes, ‘h’ being hours, ‘d’ being 
days, and ‘w’ being weeks. For example, “-qlh30m” or “-q90m” 
would both set the timeout to one hour thirty minutes. 

— r name 

An alternate and obsolete form of the -f flag. 

-t Read message for recipients. To:, Cc:, and Bcc: lines will be scanned 
for people to send to. The Bcc: line will be deleted before transmis- 
sion. Any addresses in the argument list will be suppressed. 

-v Go into verbose mode. Alias expansions will be announced, etc. 

There are also a number of processing options that may be set. Normally 
these will only be used by a system administrator. Options may be set 
either on the command line using the -o flag or in the configuration file. 
These are described in detail in the Installation and Operation Guide. The 
options are: 

Afile Use alternate alias file. 

c On mailers that are considered “expensive” to connect to, don’t ini- 
tiate immediate connection. This requires queueing. 
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dx Set the delivery mode to x. Delivery modes are T for interactive 
(synchronous) delivery, ‘b’ for background (asynchronous) delivery, 
and ‘q’ for queue only - i.e., actual delivery is done the next time the 
queue is run. 

D Try to automatically rebuild the alias database if necessary. 

ex Set error processing to mode x. Valid modes are ‘m’ to mail back the 

error message, ‘w’ to “write” back the error message (or mail it back 
if the sender is not logged in), ‘p’ to print the errors on the terminal 
(default), ‘q’ to throw away error messages (only exit status is 
returned), and ‘e’ to do special processing for the BerkNet. If the text 
of the message is not mailed back by modes ‘m’ or ‘w’ and if the 
sender is local to this machine, a copy of the message is appended to 
the file “dead.letter” in the sender’s home directory. 

F mode 

The mode to use when creating temporary files, 
f Save UNIX-style From lines at the front of messages, 
g N The default group id to use when calling mailers. 

Hfile The SMTP help file. 

i Do not take dots on a line by themselves as a message terminator. 

L n The log level. 

m Send to “me” (the sender) also if I am in an alias expansion. 

o If set, this message may have old style headers. If not set, this mes- 

sage is guaranteed to have new style headers (i.e., commas instead of 
spaces between addresses). If set, an adaptive algorithm is used that 
will correctly determine the header format in most cases. 

Qqueuedir 

Select the directory in which to queue messages, 
r timeout 

The timeout on reads; if none is set, sendmail will wait forever for a 
mailer. 

S file Save statistics in the named file. 

s Always instantiate the queue file, even under circumstances where it 
is not strictly necessary. 

T time 

Set the timeout on messages in the queue to the specified time. After 
sitting in the queue for this amount of time, they will be returned to 
the sender. The default is three days. 


September 1988 


-3- 


Version 3.0 



SENDMAIL(IM) 


Silicon Graphics 


SENDMAIL(1M) 


Xstz.dtz 

Set the name of the time zone. 


uN Set the default user id for mailers. 

If the first character of the user name is a vertical bar, the rest of the user 
name is used as the name of a program to pipe the mail to. It may be neces- 
sary to quote the name of the user to keep sendmail from suppressing the 
blanks from between arguments. 


Sendmail returns an exit status describing what it did. The codes are 
defined in <sysexits.h> 


EX_OK 
EX_NOUSER 
EX_UN AVAIL ABLE 

EX_SYNTAX 

EX_SOFTWARE 

EX_OSERR 

EX_NOHOST 

EX_TEMPFAIL 


Successful completion on all addresses. 

User name not recognized. 

Catchall meaning necessary resources were 
not available. 

Syntax error in address. 

Internal software error, including bad argu- 
ments. 

Temporary operating system error, such as 
“cannot fork”. 

Host name not recognized. 

Message could not be sent immediately, but 
was queued. 


If invoked as newaliases, sendmail will rebuild the alias database. If 
invoked as mailq, sendmail will print the contents of the mail queue. 


FILES 


Except for /usr/lib/sendmail.cf, these pathnames are all specified in 
/usr/lib/sendmail.cf. Thus, these values are only approximations. 


/usr/lib/aliases 

/usr/lib/aliases.pag 

/usr/lib/aliases.dir 

/usr/lib/sendmail.cf 

/usr/lib/sendmail.fc 

/usr/lib/sendmail.hf 

/usr/lib/sendmail. st 

/usr/bin/uux 

/usr/spool/mqueue/* 


raw data for alias names 

data base of alias names 
configuration file 
frozen configuration 
help file 

collected statistics 
to deliver uucp mail 
temp files 


SEE ALSO 

mail(l), mail_bsd(l), rmail(l), newaliases(lM), syslog(3), aliases(4), 
rc(lM); 

DARPA Internet Request For Comments RFC819, RFC821, RFC822; 
Sendmail - An Internetwork Mail Router; 

Sendmail Installation and Operation Guide. 
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BUGS 

Sendmail converts blanks in addresses to dots. This is incorrect according 
to the old ARPANET mail protocol RFC733 (NIC 41952), but is consistent 
with the new protocols (RFC822). 

ORIGIN 

4.3BSD 


September 1988 
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NAME 

setmnt - establish mount table 

SYNOPSIS 

/etc/setmnt 

DESCRIPTION 

setmnt creates the /etc/mnttab table which is needed for both the 
mount { 1M) and umount commands, setmnt reads standard input and 
creates a mnttab entry for each line. Input lines have the format: 

filesys node 

where filesys is the name of the file system’s special file (e.g., 
/dev/dsk/c?d?s?) and node is the root name of that file system. Thus 
filesys and node become the first two strings in the mount table entry. 

FILES 

/etc/mtab 
SEE ALSO 

devnm(lM), mount(lM). 

BUGS 

Problems may occur if filesys or node are longer than 32 characters. 
setmnt silently enforces an upper limit on the maximum number of mnttab 
entries. 

ORIGIN 

AT&T V.3 
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NAME 

shutdown - shut down system, change system state 
SYNOPSIS 

cd /; /etc/shutdown [ -y ] [ -ggrace_period [ -iinit_state ] 
DESCRIPTION 

This command is executed by the super-user to change the state of the 
machine. By default, it brings the system to a state where only the console 
has access to the UNIX system. This state is traditionally called "single- 
user". 

The command sends a warning message and a final message before it starts 
actual shutdown activities. By default, the command asks for confirmation 
before it starts shutting down daemons and killing processes. The options 
are used as follows: 

-y pre-answers the confirmation question so the command can be run 
without user intervention. A default of 60 seconds is allowed 
between the warning message and the final message. Another 60 
seconds is allowed between the final message and the 
confirmation. 

-g grace _period 

allows the super-user to change the number of seconds from the 
60-second default. 

— i initjstate 

specifies the state that z'wfr(lM) is to be put in following the warn- 
ings, if any. By default, system state "s" is used (the same as states 
"1" and "S”). 

Other recommended system state definitions are: 
state 0 

Shut the machine down so it is safe to remove the power. Have the 
machine remove power if it can. The letc/rcO procedure is called to 
do this work. 

state 1, s, S 

Bring the machine to the state traditionally called single-user. The 
/etc/rcO procedure is called to do this work. (Though s and 1 are both 
used to go to single user state, s only kills processes spawned by init 
and does not unmount file systems. State 1 unmounts everything 
except root and kills all user processes, except those that relate to the 
console.) 

state 5 

Stop the UNIX system and go to the firmware monitor. 
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state 6 

Stop the UNIX system and reboot to the state defined by the initde- 
fault entry in /etc/inittab. 

SEE ALSO 

init(lM), rcO(lM), rc2(lM). 

inittab(4) in the Programmer' s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

single - switch the system to single-user mode 

SYNOPSIS 

/etc/single 

DESCRIPTION 

Single switches the system to single-user mode and turns the getty s off. 
Single does not kill background processes such as cron, or update. These 
must be killed with kill or killall. Single is a shell script that invokes 
/etc/telinit. 

SEE ALSO 

multi(lM), init(lM), getty(lM), kill(l), killall(lM), inittab(4). 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

su - become super-user or another user 
SYNOPSIS 

su [ - ] [ name [ arg . . . ] ] 

DESCRIPTION 

su allows one to become another user without logging off. The default user 
name is root (i.e., super-user). 

To use su, the appropriate password must be supplied (unless one is already 
root). If the password is correct, su will execute a new shell with the real 
and effective user ID set to that of the specified user. The new shell will be 
the optional program named in the shell field of the specified user’s pass- 
word file entry (see passwd( 4)), or /bin/sh if none is specified (see sh{ 1)). 
To restore normal user ID privileges, type an EOF ( cntrl-d ) to the new shell. 

Any additional arguments given on the command line are passed to the pro- 
gram invoked as the shell. When using programs like j/j( 1), an arg of the 
form -c string executes string via the shell and an arg of -r will give the 
user a restricted shell. 

The following statements are true only if the optional program named in the 
shell field of the specified user’s password file entry is like sh( 1). If the first 
argument to su is a -, the environment will be changed to what would be 
expected if the user actually logged in as the specified user. This is done by 
invoking the program used as the shell with an argO value whose first char- 
acter is — , thus causing first the system’s profile (/etc/profile) and then the 
specified user’s profile (.profile in the new HOME directory) to be exe- 
cuted. Otherwise, the environment is passed along with the possible excep- 
tion of $PATH, which is set to 

/usr/sbin:/usr/bsd:/bin:/etc:/usr/bin:/usr/etc for root. Note that if the 
optional program used as the shell is /bin/sh, the user’s .profile can check 
argO for -sh or -su to determine if it was invoked by login{ 1) or ,™(1), 
respectively. If the user’s program is other than /bin/sh, then .profile is 
invoked with an argO of -program by both login( 1) and su(l). 

All attempts to become another user using su are logged in the log file 
/usr/adm/sulog. 

EXAMPLES 

To become user bin while retaining your previously exported environment, 
execute: 


su bin 

To become user bin but change the environment to what would be expected 
if bin had originally logged in, execute: 
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su - bin 

To execute command with the temporary environment and permissions of 
user bin, type: 


su - bin -c "command args" 


FILES 

/etc/passwd 

/etc/profile 

$HOME/.profile 

/usr/adm/sulog 


system’s password file 
system’s profile 
user’s profile 
log file 


SEE ALSO 

env(l), login(l), sh(l) in the User’ s Reference Manual. 

passwd(4), profile(4), environ(5) in the Programmer' s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

swap - swap administrative interface 
SYNOPSIS 

/etc/swap —a swapdev swaplow swaplen 
/etc/swap -d swapdev swaplow 
/etc/swap -1 

DESCRIPTION 

swap provides a method of adding, deleting, and monitoring the system 
swap areas used by the memory manager. The following options are recog- 
nized: 

—a Add the specified swap area, swapdev is the name of the block spe- 
cial device, swaplow is the offset in 512-byte blocks into the device 
where the swap area should begin, swaplen is the length of the swap 
area in 512-byte blocks. This option can only be used by the super- 
user. Swap areas are normally added by the system start up routines 
in /etc/rc2.d when going into multi-user mode. 

— d Delete the specified swap area, swapdev is the name of block special 
device, e.g., /dev/dsk/dks0d2sl. swaplow is the offset in 512-byte 
blocks into the device where the swap area should begin. Using this 
option marks the swap area as "INDEL" (in process of being deleted). 
The system will not allocate any new blocks from the area, and will 
try to free swap blocks from it. The area will remain in use until all 
blocks from it are freed. This option can only be used by the super- 
user. 

—1 List the status of all the swap areas. The output has four columns: 

DEV The swapdev special file for the swap area if one can be 
found in the /dev/dsk or /dev directories, and its 
major/minor device number in decimal. 

LOW The swaplow value for the area in 5 12-byte blocks. 

LEN The swaplen value for the area in 512-byte blocks. 

FREE The number of free 512-byte blocks in the area. If the swap 
area is being deleted, this column will be marked INDEL. 

WARNINGS 

No check is done to see if a swap area being added overlaps with an exist- 
ing swap area or file system. 

ORIGIN 

AT&T V.3 
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NAME 

sync - update the super block 

SYNOPSIS 

sync 

DESCRIPTION 

sync executes the sync system primitive. If the system is to be stopped, 
sync must be called to insure file system integrity. It will flush all previ- 
ously unwritten system buffers out to disk, thus assuring that all file 
modifications up to that point will be saved. See sync (2) for details. 

NOTES 

If you have done a write to a file on a remote machine using NFS, you can- 
not use sync to force buffers to be written out to disk on the remote 
machine, sync will only write local buffers to local disks. 

Note that the sync command may complete and the user may get another 
shell prompt before the flushing of memory buffers to disk is complete. 
sync merely schedules the buffers to be written before exiting. 

SEE ALSO 

sync(2) in the Programmer’ s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

syslogd - log systems messages 
SYNOPSIS 

/usr/etc/syslogd [ -iconfigfile ] [ -m markinterval ] [ -d ] 

DESCRIPTION 

Syslogd reads and logs messages into a set of files described by the 
configuration file /etc/syslog.conf. Each message is one line. A message 
can contain a priority code, marked by a number in angle braces at the 
beginning of the line. Priorities are defined in <sys/syslog.h>. Syslogd 
reads from the named pipe / dev/ log. 

Syslogd configures when it starts up and whenever it receives a hangup sig- 
nal. Lines in the configuration file have a selector to determine the message 
priorities to which the line applies and an action. The action field are 
separated from the selector by one or more tabs. 

Selectors are semicolon separated lists of priority specifiers. Each priority 
has a facility describing the part of the system that generated the message, a 
dot, and a level indicating the severity of the message. Symbolic names 
may be used. An asterisk selects all facilities. All messages of the 
specified level or higher (greater severity) are selected. More than one 
facility may be selected using commas to separate them. For example: 

*.emerg;mail,daemon.crit 

Selects all facilities at the emerg level and the mail and daemon facilities at 
the crit level. 

Known facilities and levels recognized by syslogd are those listed in sys- 
log( 3) without the leading “LOG_”. The additional facility “mark” has a 
message at priority LOG_INFO sent to it every 20 minutes (this may be 
changed with the — m flag). The “mark” facility is not enabled by a facility 
field containing an asterisk. The level “none” may be used to disable a 
particular facility. For example, 

* ,debug;mail.none 

Sends all messages except mail messages to the selected file. 

The second part of each line describes where the message is to be logged if 
this line is selected. There are four forms: 

• A filename (beginning with a leading slash). The file will be opened in 
append mode. 

• A hostname preceeded by an at sign (“@”). Selected messages are 
forwarded to the syslogd on the named host. 
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• A comma separated list of users. Selected messages are written to those 
users if they are logged in. 

• An asterisk. Selected messages are written to all logged-in users. 


Blank lines and lines beginning with *#’ are ignored. 
For example, the configuration file: 


kem,mark.debug 

*.notice;mail.info 

*.crit 

kem.err 

*.emerg 

*.alert 

*.alert;auth.waming 


/dev/console 

/usr/adm/notice 

/usr/adm/critical 

@ucbarpa 

* 

ericjcridle 

ralph 


logs all kernel messages and 20 minute marks onto the system console, all 
notice (or higher) level messages and all mail system messages except 
debug messages into the file /usr/adm/notice, and all critical messages into 
/usr/adm/critical; kernel messages of error severity or higher are forwarded 
to ucbarpa. All users will be informed of any emergency messages, the 
users “eric” and “kridle” will be informed of any alert messages, and the 
user “ralph” will be informed of any alert message, or any warning mes- 
sage (or higher) from the authorization system. 


The flags are: 

-f Specify an alternate configuration file. 

-m Select the number of minutes between mark messages, 
-d Turn on debugging. 


FILES 


Syslogd creates the file /etc/syslog.pid, if possible, containing a single line 
with its process id. This can be used to kill or reconfigure syslogd. 

To bring syslogd down, it should be sent a terminate signal (e.g. kill 'cat 
/etc/syslog.pid'). 

/etc/syslog.conf the configuration file 

/etc/syslog.pid the process id 

/dev/log Named pipe read by syslogd 


SEE ALSO 

syslog(3) 


ORIGIN 

4.3BSD 
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NAME 

talkd - remote user communication server 

SYNOPSIS 

/usr/etc/talkd 

DESCRIPTION 

Talkd is the server that notifies a user that somebody else wants to, initiate a 
conversation. It acts a repository of invitations, responding to requests by 
clients wishing to rendezvous to hold a conversation. In normal operation, 
a client, the caller, initiates a rendezvous by sending a CTL_MSG to the 
server of type LOOK_UP (see <protocolsltalkd.h>). This causes the server 
to search its invitation tables to check if an invitation currently exists for the 
caller (to speak to the callee specified in the message). If the lookup fails, 
the caller then sends an ANNOUNCE message causing the server to broad- 
cast an announcement on the callee’s login ports requesting contact. When 
the callee responds, the local server uses the recorded invitation to respond 
with the appropriate rendezvous address and the caller and callee client pro- 
grams establish a stream connection through which the conversation takes 
place. 

SEE ALSO 

talk(l), write(l) 

ORIGIN 

4.3BSD 
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NAME 

telnetd - DARPA Internet TELNET protocol server 

SYNOPSIS 

/usr/etc/telnetd 

DESCRIPTION 

Telnetd is a server which supports the DARPA Internet standard TELNET 
virtual terminal protocol. Telnetd is invoked by the Internet super-server 
(see inetd( 1M)), normally for requests to connect to the TELNET port as 
indicated by the t etc! services file (see services (4)). 

Telnetd operates by allocating a pseudo-terminal device (see ptyifl)) for a 
client, then creating a login process which has the slave side of the pseudo- 
terminal as stdin, stdout, and stderr. Telnetd manipulates the master side 
of the pseudo-terminal, implementing the TELNET protocol and passing 
characters between the remote client and the login process. 

When a TELNET session is started up, telnetd sends TELNET options to 
the client side indicating a willingness to do remote echo of characters, to 
suppress go ahead, and to receive terminal type information from the 
remote client. If the remote client is willing, the remote terminal type is 
propagated in the environment of the created login process. The pseudo- 
terminal allocated to the client is configured to operate in “cooked” mode, 
and with XTABS and CRMOD enabled (see termio(l)). 

Telnetd is willing to do: echo, binary, suppress go ahead, and timing 
mark. Telnetd is willing to have the remote client do: binary, terminal 
type , and suppress go ahead. 

SEE ALSO 

telnet(lC) 

BUGS 

Some TELNET commands are only partially implemented. 

The TELNET protocol allows for the exchange of the number of lines and 
columns on the user’s terminal, but telnetd doesn’t make use of them. 

Because of bugs in the original 4.2 BSD telnet( 1C), telnetd performs some 
dubious protocol exchanges to try to discover if the remote client is, in fact, 
a 4.2 BSD telnet{\C). 

Binary mode has no common interpretation except between similar operat- 
ing systems (Unix in this case). 

The terminal type name received from the remote client is converted to 
lower case. 
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The packet interface to the pseudo- terminal (see pty(J)) should be used for 
more intelligent flushing of input and output queues. 

Telnetd never sends TELNET go ahead commands. 

ORIGIN 

4.3BSD 


Version 3.0 
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NAME 

tftpd - DARPA Internet Trivial File Transfer Protocol server 

SYNOPSIS 

/usr/etc/tftpd 

DESCRIPTION 

Tftpd is a server which supports the DARPA Internet Trivial File Transfer 
Protocol. The TFTP server operates at the port indicated in the “tftp” ser- 
vice description; see services^ 4). The server is normally started by 
inetd(lM). 

The use of tftp does not require an account or password on the remote sys- 
tem. Due to the lack of authentication information, ftpd will allow only 
publicly readable files to be accessed. Files may be written only if they 
already exist and are publicly writable. Note that this extends the concept 
of “public” to include all users on all hosts that can be reached through the 
network; this may not be appropriate on all systems, and its implications 
should be considered before enabling tftp service. The server should be 
configured in inetd.conf to run as the user ID with the lowest possible 
privilege. 

SEE ALSO 

tftp(lC), inetd(lM) 

ORIGIN 

4.3BSD 
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NAME 

tic - terminfo compiler 

SYNOPSIS 

tic [-v[n]] [-c] file 

DESCRIPTION 

tic translates a terminfo{ 4) file from the source format into the compiled for- 
mat. The results are placed in the directory lusrlliblterminfo. The compiled 
format is necessary for use with the library routines described in 
curses(3X). 

-vn (verbose) output to standard error trace information showing tic’s 
progress. The optional integer n is a number from 1 to 10, 
inclusive, indicating the desired level of detail of information. If 
n is omitted, the default level is 1. If n is specified and greater 
than 1, the level of detail is increased. 

-c only check file for errors. Errors in use= links are not detected. 

file contains one or more terminfo( 4) terminal descriptions in source 
format (see terminfo{ 4)). Each description in the file describes 
the capabilities of a particular terminal. When a use=entry-name 
field is discovered in a terminal entry currently being compiled, 
tic reads in the binary from lusrlliblterminfo to complete the 
entry. (Entries created from file will be used first. If the environ- 
ment variable TERMINFO is set, that directory is searched instead 
of lusrlliblterminfo .) tic duplicates the capabilities in entry-name 
for the current entry, with the exception of those capabilities that 
explicitly are defined in the current entry. 

If the environment variable TERMINFO is set, the compiled results are 
placed there instead of lusrlliblterminfo. 

FILES 

/usr/lib/terminfo/?/* compiled terminal description data base 

SEE ALSO 

curses(3X), term(4), terminfo(4) in the Programmer’ s Reference Manual. 
Programmer' s Guide. 

WARNINGS 

Total compiled entries cannot exceed 4096 bytes. The name field cannot 
exceed 128 bytes. 

Terminal names exceeding 14 characters will be truncated to 14 characters 
and a warning message will be printed. 

When the -c option is used, duplicate terminal names will not be diag- 
nosed; however, when -c is not used, they will be. 
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BUGS 

To allow existing executables from the previous release of the UNIX System 
to continue to run with the compiled terminfo entries created by the new 
terminfo compiler, cancelled capabilities will not be marked as cancelled 
within the terminfo binary unless the entry name has a “+’ within it. (Such 
terminal names are only used for inclusion within other entries via a use= 
entry. Such names would not be used for real terminal names.) 

For example: 

4415+nl, kfl@,kf2@ 

4415+base, kfl=\EOc, kf2=\EOd, .... 

4415-nll4415 terminal without keys, 
use=4415+nl, use=4415+base, 

The above example works as expected; the definitions for the keys do not 
show up in the 4415-nl entry. However, if the entry 4415 +nl did not have 
a plus sign within its name, the cancellations would not be marked within 
the compiled file and the definitions for the function keys would not be can- 
celled within 4415-nl. 

DIAGNOSTICS 

Most diagnostic messages produced by tic during the compilation of the 
source file are preceded with the approximate line number and the name of 
the terminal currently being worked on. 

mkdir ... returned bad status 

The named directory could not be created. 

File does not start with terminal names in column one 

The first thing seen in the file, after comments, must be the list of 
terminal names. 

Token after a seek( 2) not NAMES 

Somehow the file being compiled changed during the compilation. 

Not enough memory for use_list element 
or 

Out of memory 

Not enough free memory was available (malloc{ 3) failed). 

Can’t open ... 

The named file could not be created. 

Error in writing ... 

The named file could not be written to. 
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Can’t link ... to ... 

A link failed. 

Error in re-reading compiled file ... 

The compiled file could not be read back in. 

Premature EOF 

The current entry ended prematurely. 

Backspaced off beginning of line 

This error indicates something wrong happened within tic. 

Unknown Capability - "..." 

The named invalid capability was found within the file. 

Wrong type used for capability "..." 

For example, a string capability was given a numeric value. 

Unknown token type 

Tokens must be followed by ‘@’ to cancel, for booleans, '#’ for 
numbers, or *=’ for strings. 

bad term name 
or 

Line ...: Illegal terminal name - "..." 

Terminal names must start with a letter or digit 

The given name was invalid. Names must not contain white space 
or slashes, and must begin with a letter or digit. 

terminal name too long. 

An extremely long terminal name was found. 

terminal name too short. 

A one-letter name was found. 

"..." filename too long, truncating to "..." 

The given name was truncated to 14 characters due to UNIX file 
name length limitations. 

"..." defined in more than one entry. Entry being used is 
An entry was found more than once. 

Terminal name "..." synonym for itself 

A name was listed twice in the list of synonyms. 

At least one synonym should begin with a letter. 

At least one of the names of the terminal should begin with a letter. 

Illegal character - "..." 

The given invalid character was found in the input file. 
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Newline in middle of terminal left off of the list of names. 

The trailing comma was probab y 

Missing comma 

A comma was missmg. 

MiSS “' S "Xtm't” as missing after a numeric capability. 

NUU ' "fi proper way to say mat a suing capability does no, exist is to 
cancel it. 

Very long string found. Missing comma? 
self-explanatory 

Unknown option. Usage is: 

An invalid option was entered. 

Too many file names. Usage is: 
self-explanatory 

« tt nnn-existant or permission denied 
- n ° S? given directory could not be written into. 

is not a directory 

self-explanatory 

Permission denied 
access denied. 

to use the given name as a directory, but it already 
exists as a file 

SYSTEM ERROR!! Fork failed!!! 

Afork(2) failed. 

Error in Mowing up use-linkn Bite *£ ^o^the »trii 
reference non-existant termmals. The followmg 

involved: ranability either referenced a 

solhow referred bach 

trivp.n entrv. 
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NAME 

timed - time server daemon 

SYNOPSIS 

/usr/etc/timed [ -t ] [ -M ] [ -F hostl host2 ...] [ -n network ] [ -i 
network ] 

DESCRIPTION 

Timed is the time server daemon and is normally invoked at boot time from 
the /etc/init.d/network file. It synchronizes the host’s time with the time of 
other machines in a local area network running timed. These time servers 
will slow down the clocks of some machines and speed up the clocks of 
others to bring them to the average network time. The average network 
time is computed from measurements of clock differences using the ICMP 
timestamp request message. 

The service provided by timed is based on a master-slave scheme. When 
timed is started on a machine, it asks the master for the network time and 
sets the host’s clock to that time. After that, it accepts synchronization mes- 
sages periodically sent by the master and calls adjtime{ 2) to perform the 
needed corrections on the host’s clock. 

It also communicates with date( 1) in order to set the date globally, and with 
timedc(\M), a timed control program. If the machine running the master 
crashes, then the slaves will elect a new master from among slaves running 
with the -M flag. A timed running without the -M flag will remain a slave. 
The -F flag means only the local machine and the machines hostl, host2, 
etc., are trusted to have good hardware clocks and to be securely admin- 
istered. Any attempts to change the clocks by other machines will be 
ignored. The -t flag enables timed to trace the messages it receives in the 
file /usr/adm/timed.log. Tracing can be turned on or off by the program 
timedc( 1M). Timed normally checks for a master time server on each net- 
work to which it is connected, except as modified by the options described 
below. It will request synchronization service from the first master server 
located. If permitted by the — M flag, it will provide synchronization service 
on any attached networks on which no current master server was detected. 
Such a server propagates the time computed by the top-level master. The 
-n flag, followed by the name of a network which the host is connected to 
(see networks (4)), overrides the default choice of the network addresses 
made by the program. Each time the -n flag appears, that network name is 
added to a list of valid networks. All other networks are ignored. The — i 
flag, followed by the name of a network to which the host is connected (see 
networks (4)), overrides the default choice of the network addresses made 
by the program. Each time the -i flag appears, that network name is added 
to a list of networks to ignore. All other networks are used by the time dae- 
mon. The -n and -i flags are meaningless if used together. 
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FILES 

/usr/adm/timed.log tracing file for timed 

/usr/adm/timed.masterlog log file for master timed 

SEE ALSO 

date(l), adjtime(2), gettimeofday(2), icmp(4P), timedc(lM), 

ORIGIN 

4.3BSD 
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NAME 

timedc - timed control program 
SYNOPSIS 

/usr/etc/timedc [ command [ argument ... ] ] 

DESCRIPTION 

Timedc is used to control the operation of the timed( 1M) program. It may 
be used to: 

• measure the differences between machines’ clocks, 

• find the location where the master time server is running, 

• enable or disable tracing of messages received by timed, and 

• perform various debugging actions. 

Without any arguments, timedc will prompt for commands from the stan- 
dard input. If arguments are supplied, timedc interprets the first argument 
as a command and the remaining arguments as parameters to the command. 
The standard input may be redirected causing timedc to read commands 
from a file. Commands may be abbreviated; recognized commands are: 

? [ command ... ] 

help [ command ... ] 

Print a short description of each command specified in the argu- 
ment list, or, if no arguments are given, a list of the recognized 
commands. 

clockdiff host ... 

Compute the differences between the clock of the host machine 
and the clocks of the machines given as arguments. 

trace { on I off } 

Enable or disable the tracing of incoming messages to timed in the 
file /usr/adm/timed.log. 

quit 

Exit from timedc. 

Other commands may be included for use in testing and debugging timed ; 
the help command and the program source may be consulted for details. 

FILES 

/usr/adm/timed.log tracing file for timed 

/usr/adm/timed.masterlog log file for master timed 

SEE ALSO 

date(l), timed(lM), adjtime(2), icmp(7P) 
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DIAGNOSTICS 

?Ambiguous command abbreviation matches more than one command 

?Invalid command no match found 

?Privileged command command can be executed by root only 

ORIGIN 

4.3BSD 


Version 3.0 
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NAME 

timeslave - ’slave’ local clock to a better one 
SYNOPSIS 

timeslave [ options ] — H netmaster 
timeslave [ options ] -C tty 

where options can be any of: 

[ -m ] [ -d ] [ -B ] [ -w icmp-wait ] [ — W time-wait ] 

[ -t min-trials ] [ -T max-trials ] [ -r rate ] 

[ -p port ] [ -D max-drift ] 

DESCRIPTION 

Timeslave matches the clock in the local machine to a better clock. It does 
this by speeding up or slowing down the local clock, or if the local clock is 
particularly wrong, by changing the date. When the date is changed, 
because the difference is too great to correct smoothly, timeslave logs the 
event in the system log. 

Timeslave understands several options: 

— H netmaster 

specifies the hostname or Internet address of another machine that 
has a better clock or that has, in turn, slaved its clock to a better 
one. Either a host must be specified with -H or a device must be 
specified with -C, but not both. 

-C tty specifies the filename of a tty port, such as /dev/ttyd2, with a Preci- 
sion Time Standards WWV receiver. 

It is usually not necessary to use the following options to change the default 
values compiled in timeslave: 

-m causes timeslave to measure the difference between the local and 
remote clock (or WWV receiver), but to not change the local 
clock. 

-d increases the ’debugging level,’ causing more messages to appear 
in the system log. Specifying this option several times increases 
the level. 

-B disables the normal ’backgrounding’ of the deamon. 

-w icmp-wait 

is the number of seconds before an ICMP timestamp packet is 
assumed to have been lost in the network. -W time-wait the 
number of seconds before the remote machine is assumed to be not 
answering time service requests. The first time the remote 
machine fails to answer a time service request is logged in the sys- 
tem log. Additional failures are also logged if debugging is 
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requested. 

— t min-trials 

specifies the mininum number of ICMP packets to use to deter- 
mine the time difference. 

-T max-trials 

specifies the maximum number of ICMP packets to use to deter- 
mine the time difference. If the remote machine does not respond 
to this many requests, it is assumed to be temporarily dead. 

-r rate specifies the approximate number of seconds between measure- 
ments. The time between one measurement and the next is 
changed slightly each time to avoid systematic errors caused by 
other activity in the machines or the network in general. For 
example, cron starts a request in the first few seconds of a minute. 

-p port is the port number on which the other machine provides Internet 
time service, as describe in RFC-868. 

-D max-drift 

specifies the maximum rate at which the local and remote clocks 
can be expected to drift, in microseconds. This is used to discard 
bad measurements. 

Timeslave consumes less network bandwidth, fewer CPU cycles and less 
memory on both the local and remote machines than timed{ 1M). Timed is 
appropriate for a group of peers which average their equivalently accurate 
clocks to find a better estimate of the correct time. Because the master of 
the network time is elected by the timed participants, more correct time can 
be maintained despite the failure of individual systems. 

A small, homogeneous group of machines should use timed, rather than 
timeslave. In a large network, one should use a small group of trusted, 
well-administered machines running timed with the -F option to exclude 
other machines. The excluded machines should run timed with only the -M 
flag. One of the trusted machines should, if possible, be slaved with 
timeslave to a WWV receiver, or some remote machine with a very accu- 
rate clock. This machine should be lightly loaded, and should use the -F 
option with timed to make itself the most trusted time keeper in the local 
network. This scheme, a “king” with a circle of trusted substitutes sur- 
rounded by a larger number of machines should be replicated on each sub- 
network in an installation, building a hierarchy of domains. The local king 
can use timeslave to synchronize its clock to very remote machines over 
low-performance, wide-area networks such as the DARPA Internet. 

Timeslave operates in one of two modes. In the first, it matches the clock in 
the local machine to the clock in some other machine. It sends UDP 
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datagrams to the ’time’ service on the other machine to determine the 
current day. The time service on machines using 4.3BSD-style networking 
is provided by the inetd(lM) deamon. This allows timeslave to determine 
the correct day. Timeslave then uses ICMP timestamp packets to measure 
difference between the local and remote clocks in milliseconds. It assumes 
that the round trip delay for packets to and from the remote machine is sym- 
metric. This is usually a valid assumption. However, large network data 
transfers can make transmission delays tens of thousands of times larger or 
smaller than reception delays. Therefore, timeslave elaborately filters and 
averages its measurements. In addition, it lowers its scheduling priority to 
minimize the effects of other programs on the local machine. 

The second mode in which timeslave can operate is with a Precision Time 
Standards WWV receiver. In this case, it still must average its measure- 
ments to compensate for variable scheduling delays due to the operating 
system. 

FILES 

/usr/adm/SYSLOG system log 

/dcv/ttydx tty port attached to clock. 

SEE ALSO 

inetd(lM), syslog(lM), timed(lM), timedc(lM), icmp(7P) 

BUGS 

The filtering is not good enough when the local clock is worse than one part 
in 10**4 or the network is overloaded. 

Timeslave does not communicate its confidence in the time to a timed run- 
ning on the local machine. 

AUTHOR 

Vernon Schryver 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

uadmin - administrative control 
SYNOPSIS 

/etc/uadmin cmd fen 
DESCRIPTION 

The uadmin command provides control for basic administrative functions. 
This command is tightly coupled to the System Administration procedures 
and is not intended for general use. It may be invoked only by the super- 
user. 

The arguments cmd (command) and fen (function) are converted to integers 
and passed to the uadmin system call. 

SEE ALSO 

uadmin(2) in the Programmer' s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

uucheck - check the uucp directories and permissions file 
SYNOPSIS 

/usr/lib/uucp/uucheck [ -v ] [ -x debug_level ] 

DESCRIPTION 

uucheck checks for the presence of the uucp system required files and direc- 
tories. Within the uucp makefile, it is executed before the installation takes 
place. It also checks for some obvious errors in the Permissions file 
(/usr/lib/uucp/Permissions). When executed with the — v option, it gives a 
detailed explanation of how the uucp programs will interpret the Permis- 
sions file. The -x option is used for debugging, debug-option is a single 
digit in the range 1-9; the higher the value, the greater the detail. 

Note that uucheck can only be used by the super-user or uucp. 

FILES 

/usr/lib/uucp/S y stems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuscheds 

/usr/lib/uucp/Maxuuxqts 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

SEE ALSO 

uucico(lM), uusched(lM). 

uucp(lC), uustat(lC), uux(lC) in the U ser’ s Reference Manual. 

BUGS 

The program does not check file/directory modes or some errors in the Per- 
missions file such as duplicate login or machine name. 

ORIGIN 

AT&T V.3 
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NAME 

uucico - file transport program for the uucp system 
SYNOPSIS 

/usr/lib/uucp/uucico [ -r role_number ] [ -x debugjevel ] 

[ -i interface ] [ -d spool_directory ] -s system_name 

DESCRIPTION 

uucico is the file transport program for uucp work file transfers. Role 
numbers for the -r are the digit 1 for master mode or 0 for slave mode 
(default). The -r option should be specified as the digit 1 for master mode 
when uucico is started by a program or cron. Uux and uucp both queue jobs 
that will be transferred by uucico. It is normally started by the scheduler, 
uusched , but can be started manually; this is done for debugging. For 
example, the shell Uutry starts uucico with debugging turned on. A single 
digit must be used for the -x option with higher numbers for more debug- 
ging- 

The -i option defines the interface used with uucico. This interface only 
affects slave mode. Known interfaces are UNIX (default), TLI (basic Tran- 
sport Layer Interface), and TLIS (Transport Layer Interface with Streams 
modules, read/write). 

FILES 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Devconfig 

/usr/lib/uucp/Sysfiles 

/usr/lib/uucp/Maxuuxqts 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

SEE ALSO 

cron(lM), uusched(lM), uutry(lM). 

uucp(lC), uustat(lC), uux(lC) in the U ser’ s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

uucleanup - uucp spool directory clean-up 
SYNOPSIS 

/usr/lib/uucp/uucleanup [ -C time ] [ -W time ] [ -Xtime ] [ -m string ] 

[ — o time ] [ — s system ] 

DESCRIPTION 

uucleanup will scan the spool directories for old files and take appropriate 
action to remove them in a useful way: 

Inform the requestor of send/receive requests for systems that can not be 
reached. 

Return mail, which cannot be delivered, to the sender. 

Delete or execute mews for mews type files (depending on where the news 
originated — locally or remotely). 

Remove all other files. 

In addition, there is provision to warn users of requests that have been wait- 
ing for a given number of days (default 1). Note that uucleanup will pro- 
cess as if all option times were specified to the default values unless time is 
specifically set. 

The following options are available. 

-C time Any C. files greater or equal to time days old will be removed 
with appropriate information to the requestor, (default 7 days) 

-D time Any D. files greater or equal to time days old will be removed. 

An attempt will be made to deliver mail messages and execute 
mews when appropriate, (default 7 days) 

-W time Any C. files equal to time days old will cause a mail message to 

be sent to the requestor warning about the delay in contacting 
the remote. The message includes the JOBID, and in the case 
of mail, the mail message. The administrator may include a 
message line telling whom to call to check the problem (— m 
option), (default 1 day) 

-Xtime Any X. files greater or equal to time days old will be removed. 

The D. files are probably not present (if they were, the X. could 
get executed). But if there are D. files, they will be taken care 
of by D. processing, (default 2 days) 

-m string This line will be included in the warning message generated by 
the -W option. 
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-o time Other files whose age is more than time days will be deleted. 

(default 2 days) The default line is "See your local administra- 
tor to locate the problem". 

— s system Execute for system spool directory only. 

-xdebugjevel 

The -x debug level is a single digit between 0 and 9; higher 
numbers give more detailed debugging information. (If 
uucleanup was compiled with -DSMALL, no debugging output 
will be available.) 

This program is typically started by the shell uudemon.cleanup, which 
should be started by cron{ 1M). 

FILES 

/usr/lib/uucp directory with commands used by uucleanup inter- 

nally 

/usr/spool/uucp spool directory 

SEE ALSO 

cron(lM). 

uucp(lC), uux(lC) in the User’ s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

uugetty - set terminal type, modes, speed, and line discipline 
SYNOPSIS 

/usr/lib/uucp/getty [ -h ] [ -t timeout ] [ -r ] line 
[ speed [ type [ linedisc ] ] ] 

/usr/lib/uucp/getty -c file 

DESCRIPTION 

uugetty is identical to getty(\M) but changes have been made to support 
using the line for uucico, cu, and ct; that is, the line can be used in both 
directions. The uugetty will allow users to login, but if the line is free, 
uucico, cu, or ct can use it for dialing out. The implementation depends on 
the fact that uucico, cu, and ct create lock files when devices are used. 
When the "open()" returns (or the first character is read when -r option is 
used), the status of the lock file indicates whether the line is being used by 
uucico, cu, ct, or someone trying to login. Note that in the -r case, several 
<carriage-retum> characters may be required before the login message is 
output. The human users will be able to handle this slight inconvenience. 
Uucico trying to login will have to be told by using the following login 
script: 

"" V'dV'dSiVbr in:--in: . . . 

where the . . . is whatever would normally be used for the login sequence. 

An entry for an intelligent modem or direct line that has a uugetty on each 
end must use the -r option. (This causes uugetty to wait to read a character 
before it puts out the login message, thus preventing two uugettys from 
looping.) If there is a uugetty on one end of a direct line, there must be a 
uugetty on the other end as well. Here is an /etc/inittab entry using uugetty 
on an intelligent modem or direct line: 

30:2:respawn:/usr/lib/uucp/uugetty -r -t 60 ttym2 dx_2400 none LDISC1 

Please note that the ttym* or ttyf* device names must be used in the 
/usr/Iib/uucp/Devices and /etc/inittab files and with the cu command, 
because uugetty depends on the modem to provide the signal DCD, Carrier 
Sense, on pin 8, and on the operating system to act on its state. When using 
the cu command on a line shared with uugetty, the line cannot be specified 
explicitly. Instead, it must be specified implicitly with the 
/usr/lib/uucp/Devices and /usr/lib/uucp/Dialers files. 

Also note that a /etc/gettydefs entry which cycles among the speed(s) 
appropriate for the modem should be chosen. 

FILES 

/etc/gettydefs 

/etc/issue 
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SEE ALSO 

duart(7), getty(lM), init(lM), tty(7), uucico(lM). 

ct(lC), cu(lC), login(l) in the User’ s Reference Manual. 

ioctl(2), gettydefs(4), inittab(4) in the Programmer' s Reference Manual. 

BUGS 

Ct will not work when uugetty is used with an intelligent modem such as 
penril or ventel. 

ORIGIN 

AT&T V.3 


Version 3.0 
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NAME 

uusched - the scheduler for the uucp file transport program 
SYNOPSIS 

/usr/lib/uucp/uusched [ -x debug_level ] [ -u debugjevel ] 
DESCRIPTION 

uusched is the uucp file transport scheduler. It is usually started by the dae- 
mon uudemon.hour that is started by cron( 1M) from an entry in 
/usr/spool/cron/crontab: 

39 * * * * /bin/su uucp -c "/usr/lib/uucp/uudemon.hour > /dev/null" 

The two options are for debugging purposes only; -x debugjevel will out- 
put debugging messages from uusched and -u debugjevel will be passed 
as —x debugjevel to uucico . The debugjevel is a number between 0 and 
9; higher numbers give more detailed information. 

FILES 

/usr/lib/uucp/S y stems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

SEE ALSO 

cron(lM), uucico(lM). 

uucp(lC), uustat(lC), uux(lC) in the User’ s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

Uutry - try to contact remote system with debugging on 
SYNOPSIS 

/usr/lib/uucp/Uutry [ -x debug_level ] [ -r ] system_name 
DESCRIPTION 

Uutry is a shell that is used to invoke uucico to call a remote site. Debug- 
ging is turned on (default is level 5); — x will override that value. The — r 
overrides the retry time in /usr/spool/uucp/.status. The debugging output 
is put in file l\m\>lsystem_name. A tail -f of the output is executed. A 
<DELETE> or <BREAK> will give control back to the terminal while the 
uucico continues to run, putting its output in ltmplsystem_name. 

FILES 

/usr/lib/uuc p/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuxqts 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

/tmp/system_name 

SEE ALSO 

uucico(lM). 

uucp(lC), uux(lC) in the User' s Reference Manual. 

ORIGIN 

AT&T V.3 


September 1988 
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NAME 

uuxqt - execute remote command requests 
SYNOPSIS 

/usr/lib/uucp/uuxqt [ -s system ] [ -x debug_level ] 

DESCRIPTION 

uuxqt is the program that executes remote job requests from remote systems 
generated by the use of the uux command. ( Mail uses uux for remote mail 
requests), uuxqt searches the spool directories looking for X. files. For 
each X. file, uuxqt checks to see if all the required data files are available 
and accessible, and file commands are permitted for the requesting system. 
The Permissions file is used to validate file accessibility and command exe- 
cution permission. 

There are two environment variables that are set before the uuxqt command 
is executed: 

UU_MACHINE is the machine that sent the job (the previous one). 
UU_USER is the user that sent the job. 

These can be used in writing commands that remote systems can execute to 
provide information, auditing, or restrictions. 

The -x debugjevel is a single digit between 0 and 9. Higher numbers give 
more detailed debugging information. 

FILES 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Maxuuxqts 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

SEE ALSO 

uucico(lM). 

uucp(lC), uustat(lC), uux(lC), mail(l) in the U ser' s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

versions - software versions tool 
SYNOPSIS 

versions [ options ] [ operator ] [ selectors ] 

DESCRIPTION 

versions, with no command line options, shows the names of software pro- 
ducts and images, with version numbers, installation dates, and installation 
status. The -v option expands the listing to include subsystem status, and 
the -I option restricts to those subsystems that are currently installed. The 
first column will contain an indication of the installation status of the pro- 
duct, image, or subsystem listed on that line. An “I” indicates that the 
item is installed, an “R” indicates that it was installed but has been 
removed, a “C” indicates that the installation history has somehow been 
corrupted, and a blank indicates that the item has never been installed. 

The next column gives the product, image, or subsystem name, followed by 
the date of installation and/or the version number, and the description of the 
item. 

The operators are used to perform operations on the installed subsystems. 
In this case, the options and selectors are used to restrict the operations to 
specific products, images, subsystems, and/or types of files. 

The options are as follows: 

-m Operate only on modified files; i.e. those that have been 

altered in some way since they were installed. 

-u Operate only on unmodified files; i.e. those that are still as 

originally installed. 

-c Operate only on configuration files, as defined in the 

software product. (Configuration files are editable text files 
that may be altered with site or machine-specific 
configuration information.) 

-s Operate only on system (i.e. non-configuration) files. 

-v Operate verbosely: include subsystems in the versions list, or 

display file names if they would otherwise not be, as during a 
remove. -I List installed subsystems only; don’t list subsys- 
tems that have never been installed, or have been installed 
and then removed. 

-r root Use an alternate root directory. The default is / when run- 
ning under the standard system, and /root when running in 
the miniroot (as during software installation procedures). 
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-k Do checksums of user files in the long listing. 

-i pattern Add a name or filename pattern to be included in user file 

listings. 

-e pattern Add a name or filename pattern to be excluded from the user 
file listings. 

-x Don’t use the standard exclusions table 

lusrlliblinstluserlist.exe for user file listings. 

-p Use the builtin pausing mechanism, which operates some- 

thing like more( 1). 

The operators are as follows: 

list List the selected file names. 

long List the selected file names with additional information. 

This includes the file type, the checksum at time of installa- 
tion (via "sum -r”), the size in bytes, the subsystem name, 
flags, and the file name. The file type is as follows: 

f Plain file 

d Directory 

b Block special 

c Character special 

1 Symbolic link 

p Fifo, a.k.a. named pipe 

The flags are as follows: 

c Configuration file 

t Temporary (i.e. orphaned) configuration file 

m File is machine specific (see inst(lm)) 

user List only user files, i.e. those that have not been installed as 

part of any software product. 

remove Remove the selected files from the disk. 

config Show configuration file status. This includes the existence of 

old and new versions saved with .0 and .N suffixes, and an 
indication of whether the various files have been modified 
since they were installed. This information is useful in 
reconfiguring a system after a new version of software has 
been installed. For a file foo, if there is a file foo.O, it is the 
“old” version of the file, saved during installation so that 
the new version could be put in place. In this case, the new 
file was deemed to have precedence for some reason. 
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Changes from the old version can be merged into the new 
version, if appropriate, and the old version can be removed. 
If there is a file foo. N, it is the “new” version of the file, 
installed under a different name so that the old version could 
remain active. In this case, the new version contains sug- 
gested changes that you may wish to use. Once you have 
extracted all useful information from it, it can be removed. 

Show configuration file status, but only where a .O or .N file 
is present. This operator is quite useful after installing new 
software, as it isolates the configuration files that were 
affected by the installation in some way, and need attention. 

The selectors are product, image, and/or subsystem names or shell-style 
patterns. These are used to select specific components of software pro- 
ducts. Software products are defined in a three-level hierarchy, the first of 
which is the product itself. Each product is made of one or more images. 
Each image is made of subsystems, which are logically-related collections 
of the individual files of the product. The subsystem is the generally lowest 
level at which software installation and removal decisions can be made. 

Each product, image and subsystem has a short name by which it is known 
internally, and a longer description giving an indication of its contents. 
These names are concatenated with dots to select specific components. For 
example, “foo.bar.main” is the “main” subsystem of the “bar” image of 
the “foo” software product. 

Shell-style patterns may be used to select groups of subsystems; the most 
common pattern will be of the form “foo.bar.*” to select all subsystems of 
the named image, or “foo.*.*” to select all subsystems of all images of the 
named product. Missing components in the selectors are assumed to be "*", 
so these last two examples can be abbreviated “foo.bar” and “foo”, 
respectively. 

The special pattern "user" (recognized only for the filename listing opera- 
tors) can be used to refer to all files on the system that are not part of an 
installed software product. 

AUTHOR 

Donl Mathis 

FILES 

/usr/lib/inst/* Installation history and supporting files 

/usr/lib/inst/userlist.exc Standard exclusion patterns for user lists 

SEE ALSO 

inst(lm). 
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ORIGIN 

Silicon Graphics, Inc. 
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NAME 

whodo - who is doing what 

SYNOPSIS 

/etc/whodo 

DESCRIPTION 

whodo produces formatted and dated output from information in the 
/etclutmp and Itmp/.psjiata files. 

The display is headed by the date, time and machine name. For each user 
logged in, device name, user-id and login time is shown, followed by a list 
of active processes associated with the user-id. The list includes the device 
name, process-id, cpu minutes and seconds used, and process name. 

EXAMPLE 

The command: 


whodo 

produces a display like this: 

Tue Mar 12 15:48:03 1985 
bailey 


tty 09 men 8:51 
tty09 28158 0:29 sh 


tty52 bdr 15:23 

tty52 

21688 

0:05 sh 

tty52 

22788 

0:01 whodo 

tty52 

22017 

0:03 vi 

tty52 

22549 

0:01 sh 

xtl62 lee 10:20 

tty08 

6748 

0:01 layers 

xtl62 

6751 

0:01 sh 

xtl63 

6761 

0:05 sh 

tty08 

6536 

0:05 sh 


FILES 

/etc/passwd 

/tmp/.ps_data 

/etc/utmp 

SEE ALSO 

ps(l), who(l) in the V ser’ s Reference Manual. 
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ORIGIN 

AT&T V.3 
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NAME 

intro - introduction to special files 
DESCRIPTION 

This section describes various special files that refer to specific hardware 
peripherals, and UNIX system device drivers. STREAMS [see intro{ 2)] 
software drivers, modules and the STREAMS -generic set of ioctl( 2) system 
calls are also described. 

For hardware related files, the names of the entries are generally derived 
from names for the hardware, as opposed to the names of the special files 
themselves. Characteristics of both the hardware device and the 
corresponding UNIX system device driver are discussed where applicable. 

Disk device file names are in the following format: 

/dev/{r}dsk/<device-typexcontroller-#>d<drive-#>{s<slice-#>|vh|vol} 

where r indicates a raw interface to the disk, the <device-type> indicates 
the type of device, <controlIer-#> indicates the controller number, 
<drive-#> indicates the device attached to the controller (drive number) 
and <slice-#> indicates the section number of the partitioned device. Cer- 
tain sections have alternate names, namely vh for the volume header and 
vol for the entire volume: header, defects and all. 

Tape device file names are in the following format: 

/dev/{r}mt/<device-typexcontrolIer-#>d<slave-#>{nr}{.density} 

where r indicates a raw interface to the disk, the <device-type> identifies 
the type of device that the tape is, <controller-#> indicates the controller 
number, <slave-#> indicates the device attached to the controller (slave 
number), nr indicates a non rewinding interface, and density optionally 
specifies the media density, where appropriate. For devices with only one 
density setting, density may be ommitted. The is used to keep the 
<s!ave-#> visually merging with the density. 

SEE ALSO 

prtvtoc(lM) 

DiskITape Management in the System Administrator’ s Guide. 

ORIGIN 

AT&T V.3 
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NAME 

arp - Address Resolution Protocol 
DESCRIPTION 

ARP is a protocol used to dynamically map between DARPA Internet and 
lOMb/s Ethernet addresses. It is used by all the lOMb/s Ethernet interface 
drivers. It is not specific to Internet protocols or to lOMb/s Ethernet, but 
this implementation currendy supports only that combination. 

ARP caches Intemet-Ethemet address mappings. When an interface 
requests a mapping for an address not in the cache, ARP queues the mes- 
sage which requires the mapping and broadcasts a message on the associ- 
ated network requesting the address mapping. If a response is provided, the 
new mapping is cached and any pending message is transmitted. ARP will 
queue at most one packet while waiting for a mapping request to be 
responded to; only the most recently “transmitted” packet is kept. 

To facilitate communications with systems which do not use ARP, ioctl s 
are provided to enter and delete entries in the Intemet-to-Ethemet tables. 
Usage: 

#include <sys/ioctl.h> 

#include <sys/socket.h> 

#include <net/if.h> 
struct arpreq arpreq; 

iocd(s, SIOCSARP, (caddr_t)&arpreq); 
iocd(s, SIOCGARP, (caddr_t)&arpreq); 
ioctl(s, SIOCDARP, (caddr_t)&arpreq); 

Each ioctl takes the same structure as an argument. SIOCSARP sets an 
ARP entry, SIOCGARP gets an ARP entry, and SIOCDARP deletes an 
ARP entry. These ioctls may be applied to any socket descriptor 5 -, but only 
by the super-user. The arpreq structure contains: 

/* ARP ioctl request */ 
struct arpreq { 



struct sockaddr 

arp_pa; 

/* protocol address */ 


struct sockaddr 

arpjha; 

/* hardware address */ 

1- 

int 

arp_flags; 

/* flags */ 

/* arp_flags field values 

*/ 


#define 

ATF_COM 

0 x 02 

/* completed entry (arp_ha valid) */ 

#define 

ATF_PERM 

0x04 

/* permanent entry */ 

#define 

ATF_PUBL 

0x08 

/* publish (respond for other host) */ 

#define 

ATFJJSETRAILERS 0x10 

/* send trailer packets to host */ 
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The address family for the arp _pa sockaddr must be AFJNET; for the 
arpjia sockaddr it must be AFJUNSPEC. The only flag bits which may be 
written are ATF_PERM, ATF_PUBL and ATF_USETR AILERS . 
ATF_PERM causes the entry to be permanent if the ioctl call succeeds. 
The peculiar nature of the ARP tables may cause the ioctl to fail if more 
than 8 (permanent) Internet host addresses hash to the same slot. 
ATF PUBL specifies that the ARP code should respond to ARP requests 
for the indicated host coming from other machines. This allows a host to 
act as an “ARP server,” which may be useful in convincing an ARP-only 
machine to talk to a non- ARP machine. 

ARP is also used to negotiate the use of trailer IP encapsulations; trailers 
are an alternate encapsulation used to allow efficient packet alignment for 
large packets despite variable-sized headers. Hosts which wish to receive 
trailer encapsulations so indicate by sending gratuitous ARP translation 
replies along with replies to IP requests; they are also sent in reply to IP 
translation replies. The negotiation is thus fully symmetrical, in that either 
or both hosts may request trailers. The ATFJJSETRAILERS flag is used 
to record the receipt of such a reply, and enables the transmission of trailer 
packets to that host. 

ARP watches passively for hosts impersonating the local host (i.e. a host 
which responds to an ARP mapping request for the local host’s address). 

DIAGNOSTICS 

The following messages can appear on the console: 

arp: host with ether address %x:%x:%x:%x:%x:%x is using my IP address 
x.x.x.x 

ARP has discovered another host on the local network which responds to 
mapping requests for its own Internet address, 
arp: ether address is broadcast for IP address x.x.x.x 

ARP has discovered another host on the local network which maps that 
host’s IP address onto the ethemet broadcast address. 

NOTE 

To compile and link a program that makes ARP ioctl calls, follow the pro- 
cedures for section (3B) routines as described in intro(3). 

SEE ALSO 

inet(7P), arp(lM), ifconfig(lM), intro(3) 

“An Ethemet Address Resolution Protocol,” RFC826, Dave Plummer, 
Network Information Center, SRI. 

“Trailer Encapsulations,” RFC893, S.J. Leffler and MJ. Karels, Network 
Information Center, SRI. 

BUGS 

ARP packets on the Ethemet use only 42 bytes of data; however, the 
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smallest legal Ethernet packet is 60 bytes (not including CRC). Some sys- 
tems may not enforce the minimum packet size, others will. 

ORIGIN 

4.3BSD 
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NAME 

audio - bi-directional audio channel interface 

SYNOPSIS 

/dev/audio 

DESCRIPTION 

The special file /dev/audio refers to the bi-direction audio interface on the 
IRIS 4D/20. The audio device is capable of digital record and playback as 
well as sound synthesis. The device consists of a bi-directional, 8-bit D/A 
and A/D converter with software adjustable output gain. Three different 
sampling frequency are available: 33khz, 16khz, and 8khz. 

The software interface to the audio channel consists of a single device, 
/dev/audio, that supports direct reads and writes to the D/A and A/D con- 
verters. Output gain and sampling rate may be controlled via ioctl calls to 
the device. A read of the audio channel will fill a buffer with eight bit sam- 
ples taken at the current frequency until the size of the read request is 
satisfied. A write to the audio channel will send a buffer one byte at a time 
at the current frequency until the buffer is exhausted. For sound synthesis, 
a sound duration may be specified in 1/100 Hz increments. If a duration is 
specified and the buffer is exhausted before the elapsed time has passed, the 
buffer is replayed again from the beginning. 

The following ioctls are defined in the include file <sys/audio.h> and can 
be used to control the audio channel from within a program: 

AUDIOCSETOUTGAIN Set the output gain control to the 

value specified by the argument. 
Valid values for output gain are 
numbers in the range 0 to 255. 

AUDIOCGETOUTGAIN Returns the current setting of the 

audio output gain. 

AUDIOCSETRATE Sets the input and output sam- 

pling rate according to the value 
of the argument. Possible set- 
tings are: l=33khz, 2=16khz, and 
3=8khz. 

AUDIOCDURATION Sets the sound duration to the 

value (in 1/100 Hz units) 
specified by the argument. When 
a duration is set, recording or 
playback continues until the 
duration time expires. If the i/o 
request length of the is exceeded 
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before time is up, the buffer is 
re-used. This feature can be used 
to continuously repeat a 
waveform for sound synthesis. 

FILES 

/dev/audio 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

cdsio - 6-port serial I/O 

SYNOPSIS 

/dev/tty[dmf][5-10] 

/dev/tty[dmf][13-18] 

DESCRIPTION 

6-port boards can be used for modems or other asynchronous, serial I/O 
devices. The ports provided by the cdsio board are very similar to the on- 
board duart ports. 

Various character echoing and interpreting parameters can be set indepen- 
dently for each port. See termio{l) for details. 

Depending on the minor device number, these ports support or ignore addi- 
tional signals such as DCD, RTS, and CTS. See the IR1S-4D Series 
Owner's Guide for additional information. 

This device is automatically detected, if present, and its driver is included in 
the automatically configured kernel. This probing and configuring is done 
when the system starts by the rc2 scripts. 

FILES 

/dev/tty[dmf][5-10] 

/dev/tty [dmf] [13-18] 

/dev/MAKEDEV 

/etc/init.d/autoconfig 

/usr/sysgen/system 

SEE ALSO 

duart(7), lboot(lM), rc2(lM), system(4), termio(7) 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

clone — open any minor device on a STREAMS driver 
DESCRIPTION 

clone is a STREAMS software driver that finds and opens an unused minor 
device on another STREAMS driver. The minor device passed to clone dur- 
ing the open is interpreted as the major device number of another STREAMS 
driver for which an unused minor device is to be obtained. Each such open 
results in a separate stream to a previously unused minor device. 

The clone driver consists solely of an open function. This open function 
performs all of the necessary work so that subsequent system calls (includ- 
ing close(2)) require no further involvement of clone. 

clone will generate an ENXIO error, without opening the device, if the 
minor device number provided does not correspond to a valid major device, 
or if the driver indicated is not a STREAMS driver. 

CAVEATS 

Multiple opens of the same minor device cannot be done through the clone 
interface. Executing stat(2) on the file system node for a cloned device 
yields a different result from executing fstat(2) using a file descriptor 
obtained from opening the node. 

SEE ALSO 

log(7). 

ORIGIN 

AT&T V.3 
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NAME 

console - console interface 
DESCRIPTION 

The console provides the operator interface to the system. The operating 
system and system utility programs display error messages on the system 
console. 

The console can be a serial terminal connected to the first serial port on the 
back panel of the workstation or it can be a logical terminal represented by 
a text window on the graphics monitor. 

The device special file /dev/console represents the system console. When 
the console is a window on the graphics monitor, /dev/console will be the 
slave side of pseudo-tty (see pty(7)). 

When the console is a serial terminal, the file /dev/console will be the 
appropriate DUART device. 

FILES 

/dev/console 

SEE ALSO 

termio(7). 

ORIGIN 

AT&T V.3 


September 1988 


-1 - 


Version 3.0 



DKS(7M) 


Silicon Graphics 


DKS(7M) 


NAME 

dks - Small Computer Systems Interface (SCSI) disk driver 

SYNOPSIS 

/dev/dsk/dks* 

/dev/rdsk/dks* 

DESCRIPTION 

There may be up to 7 SCSI drives attached to a system. The special files 
are named according to the convention discussed in intro(7M): 

/dev/{r}dsk/dks<controller-#>d<drive-#>{s<partition-#>[vh|vol} 

The standard partition allocation by Silicon Graphics has root on partition 
0, swap on partition 1, and lusr on partition 6. Partition 7 maps the entire 
usable portion of the disk (excluding the volume header). Partition 8 maps 
the volume header (see prtvtoc(}M), dvhtool{YM)). Partition 10 maps the 
entire drive. The remaining partitions are reserved for use by Silicon 
Graphics. 

The standard configuration has Idev/root linked to Idev/dsk/dksOdlsO, 
Idevlswap linked to Idev/dsk/dksOdlsl , and Idevlusr linked to 
Idev/dsk/dks0dls6, for systems with the root on a SCSI drive. 

IOCTL FUNCTIONS 

As well as normal read and write operations, the driver supports a number 
of special ioctl(_2 ) operations when opened via the character special file in 
/dev/rdsk. Command values for these are defined in the system include file 
<sys/dkio.h>, with data structures in <sys/dksc.h>. 

These ioctl operations are intended for the use of special-purpose disk utili- 
ties. Many of them can have drastic or even fatal effects on disk operation 
if misused; they should be invoked only by the knowledgeable and with 
extreme caution! 

A list of the ioctl commands supported by the dks driver is given below. 
DIOCADDBB 

adds a block to the badblock list. The argument is the logical 
block number (not a pointer to the block number). For some 
makes of drives, the spared block must be written before the spar- 
ing takes effect. Only programs running with superuser permis- 
sions may use this ioctl. 

DIOCDRIVETYPE 

The first 24 bytes of the SCSI inquiry data for the drive is returned 
to the caller. The argument is a pointer to a char array of at least 
24 bytes. This contains vendor and drive specific information such 
as the drive name and model number. See a SCSI command 
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specification for details on the structure of this buffer. 
DIOCFORMAT 

formats the entire drive. Any information on the drive is lost. The 
grown defect list (blocks spared with DIOCADDBB) is empty 
after formatting is complete. 

DIOCGETVH 

reads the disk volume header from the driver into a buffer in the 
calling program. The arg in the ioctl call is expected to point to a 
buffer of size at least 512 bytes. The structure of the volume 
header is defined in the include file <sys/dvh.h>. The correspond- 
ing call DIOCSETVH sets the drivers idea of the volume header; 
in particular, the drivers idea of the partition sizes and offsets is 
changed. 

DIOCRDEFECTS 

The argument is a pointer to a ’struct dk_ioctl_data’. The i_addr 
field field points to a structure like: 

structure defectjist { 

struct defect_header defhdr; 
struct defect_entry defentry[NENTS]; 

}; 

the i_len field is set to the total length of the structure, which must 
be less than NBPP from <sys/param.h>; at most NENTS defects 
will be returned. The actual number of defects may be determined 
by examining the defhdr.defectjistlen value, which is the number 
of bytes returned. This must be divided by the size of the applica- 
ble data structure for the type requested. The i_page field should 
be set to the bits identifying the badblock reporting type. These 
bits request the combination of manufacturer’s and grown defects; 
and one of bytes from index, physical cyl/head/sec, vendor unique. 
The only combination that works with all currently supported SCSI 
disks is type cyVhead/sec; and either combined manufacturer’s and 
grown defects, or just manufacturer’s defects. 

DIOCREADCAPACITY 

The arg is a pointer to an unsigned integer. The value returned is 
the number of usable sectors on the drive (as read from the drive). 

DIOCSENSE / DIOCSELECT 

The argument is a pointer to a ’struct dk_ioctl_data’. This allows 
sending SELECT and SENSE commands to the drive. See the 
ANSI SCSI specification and individual manufacturer’s manuals 
for allowed page numbers and valid values. Only programs run- 
ning with superuser permissions may use the DIOCSELECT ioctl. 
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DIOCTEST 

issues the SCSI "Send Diagnostic" command to the drive. The 
exact tests done are manufacturer specific. 

IOCTL FUNCTIONS 

As well as normal read and write operations, the driver supports a number 
of special io control (ioctl) operations when opened via the character spe- 
cial file in /dev/rdsk. These may be invoked from a user program by the 
ioctl system call, see iocd(2). Command values for these are defined in the 
system include file <sys/dkio.h>. 

These ioctl operations are intended for the use of special-purpose disk utili- 
ties. Many of them can have drastic or even fatal effects on disk operation 
if misused; they should be invoked only by the knowledgeable and with 
extreme caution! 

A list of the ioctl commands supported by the dks driver is given below. 
DIOCGETVH 

Reads the disk volume header from the driver into a buffer in the 
calling program. The argument to the ioctl call is expected to 
point to a buffer of at least size obstruct volume Jieader) bytes. 
The structure of the volume header is defined in the include file 
<sys/dvh.h>. 

DIOCSETVH 

Transfers a new volume header into the driver, and causes the disk 
drive to be reconfigured in accordance with the parameters in the 
new volume header. The argument to the ioctl call is expected to 
point to a buffer containing a valid volume header with parameters 
appropriate for the drive. 

DIOCDRIVETYPE 

The SCSI inquiry data corresponding to the drive is returned to the 
caller. The argument to the ioctl call is expected to point to a 
buffer of at least 24 bytes. This contains vendor and drive specific 
information such as the drive name and model number. See a 
SCSI command specification for details on the structure of this 
buffer. 

DIOCREADCAPACITY 

Returns the capacity in blocks of the drive (not the currently open 
partition). The argument to the ioctl call is expected to point to an 
integer (4 bytes). 

DIOCFORMAT 

Formats the entire drive. This ioctl request takes no arguments. 
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DIOCADDBB 

Add a given block to the "bad block" list, which will cause future 
accesses to this block number to access a spare block reserved for 
this purpose. The argument to the ioctl call should be the absolute 
block number of the drive (not the currently open partition). 

DIOCTEST 

Requests the drive to perform diagnostic tests on itself. The ioctl 
call will return 0 upon success, or will set errno to EIO and return 
-1 upon failure. 

FILES 

/dev/dsk/dks*, /dev/rdsk/dks* 

/dev/root, /dev/usr, /dev/swap 

SEE ALSO 

dvhtool(lM), prtvtoc(lM), fx(lM). 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

dn_ll, dn_netman - 4DDN special files 
DESCRIPTION 

The dnjl special file is used to create 4DDN logical links. Logical links 
are temporary software data paths established between two communicating 
processes in a 4DDN network and use DECnet phase-IV protocols. 

The dn netman special file is used by the 4DDN network management 
software. 

FILES 

/dev/dn_ll 

/dev/dn_netman 

SEE ALSO 

4DDN User’s Guide and 4DDN Network Manager’s Guide. 

NOTE 

These files are used only with the optional 4DDN software. 

DECnet is a trademark of Digital Equipment Corporation. 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

duart - on-board serial ports 

SYNOPSIS 

/dev/tty[dmf][l-4] 

DESCRIPTION 

There are four standard serial ports on some IRIS-4D models (such as the 
IRIS-4D/70), in addition to the two ports used for the mouse and keyboard. 
Some other IRIS-4D models have only two such ‘on-board’ ports. The first 
of these ports, /dev/ttydl, is often used for the ‘serial’ or ‘debugging’ con- 
sole. Others are commonly used for modems, a dial-and-button box, or a 
bit-pad. 

Each line may independently be set to run at any of several speeds, as high 
as 19,200 or 38,400 bps. Various character echoing and interpreting param- 
eters can also be set. See termio(l) for details. 

Depending on the minor device number, these ports support or ignore addi- 
tional signals such as DCD, RTS, and CTS. See the IRIS-4D Series 
Owner’ s Guide for additional information. 

The driver for this device must be configured in the kernel by specifying it 
with ‘INCLUDE’ in the /usr/sysgen/system file. 

FILES 

/dev/tty [dmf][ 1-4] 

/dev/MAKEDEV 

/usr/sysgen/system 

SEE ALSO 

cdsio(7), termio(7), system(4) 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

ethemet - IRIS-4D Series ethemet controllers 


DESCRIPTION 

The IRIS-4D Series supports local-area networking with the Ethemet. The 
Ethemet protocol is supported with a hardware controller and a kernel 
driver. Though the controllers are different among IRIS-4D’s, their drivers 
provide the same programming interface to networking routines. 

Each IRIS ethemet controller is named using the following convention: the 
prefix is ‘e’ and the suffix is the controller unit number. 


Controller name 

ecO 

etO 

enpO, enpl,... 


Type Model 

on-board 4D/20 

on-board 4D/80GTX, 4D/100 

CMC ENP-10 all 4D’s 


Depending on the model, an IRIS-4D can support several ethemet controll- 
ers, allowing it to act as a gateway among different local networks. 

The ethemet boards are initialized during system startup from 
/etc/init.d/network (see network^ 1M) for details). 

The IRIS-4D’s use the lOMbit/sec Ethemet encapsulation format. Each 
packet has a 14-byte header, as defined in the #include file 
<netinet/if_ether.h> : 

struct ether_header { 

unsigned char ether_dhost[6]; /* 48-bit destination address */ 

unsigned char ether_shost[6]; /* 48-bit source address */ 

unsigned short ether_type; /* packet type */ 

); 


The packet type determines which kernel protocol routine is called to pro- 
cess the packet data. Examples of common packet types are IP, ARP, and 
DECnet. 


DIAGNOSTICS 

Various error messages are printed by the kernel when a problem is encoun- 
tered. The message is preceded by the controller name, e.g., enpO. Serious 
errors are flagged with a dagger (f). If they occur repeatedly, contact your 
product support service for assistance. 

The following error messages are common to all controllers: 

packet too small (length = X) 
packet too large (length = X) 

The controller received a packet that was smaller than the 
minimum ethemet packet size of 60 bytes or larger than the max- 
imum of 1514. This problem is caused by another machine with a 
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bad ethemet controller or transceiver. 

stray interrupt 
early interrupt 

The controller interrupted the kernel before the device was initial- 
ized. This error is innocuous; it occurs after booting a kernel over 
the network from the PROM monitor. 

died and restarted 

The controller failed to respond after a certain amount of time and 
the driver had to reset it. 

cannot handle address family 

This message indicates an error in the kernel protocol handling 
routines.! 

The following messages are specific to the CMC ENP-10 controller: 
missing 

The controller did not respond to a kernel probe. This message is 
expected if the controller is not installed in the machine. 

operation not supported by the firmware 

The kernel tried to change the multicast address filter or the ether- 
net address or go into promiscuous mode, but failed because the 
firmware is out-of-date. Use the hinv( 1M) command to determine 
the firmware version and contact your product support service for 
information on upgrading the firmware. 

firmware failed to start 
detected error on reset 
timed-out waiting for reset 

These messages indicates that the controller did not reset prop- 
erly.! 

address command failed, resetting board 

An operation that tried to change the controller mode failed, prob- 
ably because the controller firmware failed. The kernel had to 
reset the board.! 

The following messages are specific to the ec and et controllers, 
transmit: no carrier 

Indicates the ethemet cable is unplugged from the machine, 
late collision 

The controller tried to transmit a packet but received a late colli- 
sion signal from another machine. Usually indicates a problem in 
the ethemet cable layout. 
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transmit ’buff’ error 
receive ’buff’ error 
transmit underflow 
receive packet overflow 

The controller ran out of memory when trying to transmit or 
receive a packet, t 

unknown interrupt 

The controller interrupted the kernel but the reason for the inter- 
rupt is missing.f 

babbling 

The kernel tried to transmit a packet larger than the maximum 
size.f 

machine has bad ethemet address: x:x:x:x:x:x 

The ethemet address obtained from non-volatile RAM during 
controller initialization was corrupted, f 

memory timeout 

The LANCE ethemet chip failed to access its local memory, f 

Counts of ethemet input and output errors can be displayed with the com- 
mand netstat -i (see netstat( 1M)). Typically, output errors and collisions 
occur due to mismatched controller and transceiver configurations. Input 
error statistics include counts of the errors listed above and counts of proto- 
col input queue overflows. 

SEE ALSO 

netstat(lM), network(lM), socket(2), ip(7P), raw_link(7P), raw_snoop(7P) 

NOTE 

IEEE 802.3 Ethemet encapsulation is not currently supported. The IRIS- 
4D ethemet controllers will support IEEE 802.3 and Ethemet v.l/v.2 electr- 
ical specifications. Contact your product support service for more informa- 
tion. 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

gpib - driver for National Instruments VME IEEE-488 controller 
DESCRIPTION 

The gpib driver provides access to instruments connected to the IEEE-488 
instrument bus, also known as the GPIB, via the National Instruments 
GPIB-1014 VME controller. Up to 16 devices may be connected to a sin- 
gle controller card, using standard GPIB cabling. 

The file lusr/include/sys/ugpib.h contains the ioctl and structure definitions 
needed for user programs to use the board. Both a read/write and an ioctl 
interface are provided. A library libgpib.a contains useful functions for 
controlling GPIB devices. 

FILES 

/dev/devl -/dev/devl6 
/dev/gpibO 

SEE ALSO 

scanner ( 1) 

The following manuals are available from National Instruments in Austin, 
Texas: 

National Instruments IEEE ^18 8 Multitasking UNIX Device Driver 
User Manual, Part #320062-01 
and 

National Instruments GPIB-1014 User Manual, Part #320030-01 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

gse - Silicon Graphics 5080 workstation interface card 
DESCRIPTION 

The special file /dev/gse provides access to the Silicon Graphics 5080 
workstation interface card which connects a Silicon Graphics 4D system to 
a Channel Controller attached to an IBM mainframe. The connection of the 
interface card can be coax, V.35 or Tl. 

This special file is used by the IBM 5080 emulator (em5080(l)). The fol- 
lowing control functions are provided by the driver to the emulator via 
ioctl(2). 

#include <sys/gseio.h> 
struct gse_io gseio; 


ioctl(fd,GIO_INIT,0); 
ioctl(fd,GIO_SETIV,0); 
ioctl(fd,GIO_W AIT, timeout); 
ioctl(fd,GIO_SIGNAL, signal); 
ioctl(fd,GIO_READ,&gseio); 
ioctl(fd,GIO_WRITE,&gseio); 


/* reset the controller */ 

/* load the intr vector */ 

/* wait for controller intr */ 

/* send signal on controller intr */ 
/* cp from controller to user buf */ 
/* cp from user buf to controller */ 


struct gse_io { 


int 

v_addr; 

/* user virtual address */ 

int 

d_addr; 

/* device real adddress */ 

int 

byte_ct; 

/* byte count */ 


}; 

Access to the board from the application level emulator is also done 
through memory mapped addressing directly. The standard mmap(2) func- 
tion is provided by the driver to set that up. 

The standard select(2) function is also supported by the driver to facilitate 
the operation on the controller event from the emulator. 


FILES 

/dev/gse 
SEE ALSO 

cleanup(l), em3270(l), em5080(l), gateway(l), ld5080(l), sh5080(l) 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

hi - hardware spinlocks driver 
DESCRIPTION 

The hi driver manages the allocation and mapping of test-and-set hardware 
that is used as the basis of user spinlocks and semaphores. 

Various driver routines and ioctl functions are available including those to 
allocate a shared lock group, allocate actual locks, and map the lock 
hardware into the user’s virtual address space. These driver routines are 
called from the various parallel processing library routines in libmpc.a. 

Tset-and-set hardware is available only on the 4D GTX models. 

FILES 

/dcv/hl/* 

SEE ALSO 

mmap(2), usinit(3P), usnewlock(3P), usnewsema(3P). 

ORIGIN 

Silicon Graphics, Inc. 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

hy - HyperNet interface 
DESCRIPTION 

The hy interface provides a character and a network device interface to a 
Network Systems Corporation A400 HYPERchannel(TM) Adaptor. 

The network to which the interface is attached is specified with an SIOCSI- 
FADDR ioctl. The routing information that maps internet addresses into 
HYPERchannel addresses is supplied to the driver by the hyroute program. 
The driver requires that both the routing tables and the interface address be 
set before any packets can be sent through the network device interface. 

Outgoing packets are stamped with the host’s address for both the network 
and character interface to prevent fraud. 

SEE ALSO 

inet(7P), hyroute(lM). 

FILES 

/usr/etc/hyroute 

/usr/etc/hyroute.conf 

/etc/init.d/network 

/etc/config/hypemet.on 

/usr/etc/hydiag 

NOTE 

HYPERchannel is a registered trademark of Network Systems Corp. 
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NAME 

icmp - Internet Control Message Protocol 
SYNOPSIS 

#include <sys/socket.h> 

#include <netinet/in.h> 

s = socket(AF_INET, SOCK RAW, proto); 

DESCRIPTION 

ICMP is the error and control message protocol used by IP and the Internet 
protocol family. It may be accessed through a “raw socket” for network 
monitoring and diagnostic functions. The proto parameter to the socket call 
to create an ICMP socket is obtained from getprotobyname{ 3N). ICMP 
sockets are connectionless, and are normally used with the sendto and 
recvfrom calls, though the connect (2) call may also be used to fix the desti- 
nation for future packets (in which case the re ad (2) or recv{ 2) and write {2) 
or send (2) system calls may be used). 

Outgoing packets automatically have an IP header prepended to them 
(based on the destination address). Incoming packets are received with the 
IP header and options intact. 

DIAGNOSTICS 

A socket operation may fail with one of the following errors returned: 

[EISCONN] when trying to establish a connection on a socket which 
already has one, or when trying to send a datagram with 
the destination address specified and the socket is already 
connected; 

[ENOTCONN] when trying to send a datagram, but no destination 
address is specified, and the socket hasn’t been con- 
nected; 

[ENOBUFS] when the system runs out of memory for an internal data 
structure; 

[E ADDRNOT AV AIL] 

when an attempt is made to create a socket with a net- 
work address for which no network interface exists. 

NOTE 

To compile and link a program that uses sockets, follow the procedures for 
section (3B) routines as described in intro( 3). 

SEE ALSO 

send(2), recv(2), intro(3), inet(7P), ip(7P) 

ORIGIN 

4.3BSD 
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NAME 

ik - Ikon 10088 hardcopy interface controller 

SYNOPSIS 

/dev/cent 

/dev/vpO 

DESCRIPTION 

This is the driver for the Ikon 10088 (and 10088A) hardcopy interface con- 
troller. The controller can support any one of three possible interfaces: 
Versatec TTL, Versatec differential, or (Tektronix-compatible) Centronics. 
The Ikon controller board must be jumpered, switched, connected, and ter- 
minated differently depending on which interface is being used. 

If the board is configured for the Centronics interface, bytes written to 
Idevlcent are output to the hardcopy port. A printer reset (input prime) is 
issued when the device file is opened. 

If the board is configured for either Versatec interface, bytes written to 
IdevIvpO are output to the hardcopy port. A printer reset is issued when the 
device file is opened. In addition, the following Versatec control calls are 
provided via ioctl{ 2). The relevant definitions are contained in the include 
file <sys/vcmd.h> . 

iocd(fd, V SETST ATE ,int_3_ptr) ; 

changes the Versatec device state according to the contents of the 
3 integers pointed at by int_3 _ptr. The first integer specifies a 
Versatec command: 

VPRINT commands the Versatec device to enter print mode; 
VPLOT commands it to enter plot mode; 

VPRINTPLOT commands it to enter simultaneous print/plot mode; 
VLF commands it to output a linefeed; 

VFF commands it to output a formfeed; 

VREOT drives the remote EOT signal. 

The second integer specifies a timeout delay (in seconds) for sub- 
sequent Versatec operations, including output operations. A 
specified delay of 0 is ignored. The default delay is 300 seconds. 
This may be insufficient for large and / or slow devices. The third 
integer is ignored. 

ioctl(fd,VGETSTATE,int_3_ptr); 

passes back Versatec device state information in the 3 integers 
pointed at by int_3 _ptr. The first integer contains: 

VPRINT if the Versatec device is in print mode; 

VPLOT if it is in plot mode; 

VPRINTPLOT if it is in simultaneous print/plot mode. 
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The second integer contains the current timeout delay (in seconds) 
(see VSETSTATE above). The third integer is not used. 

It is normally unnecessary to use Idevlcent or IdevIvpO directly; the spooling 
software (see lp{ 1)) provides an adequate interface. 

FILES 

/dev/cent 

/dev/vpO 

SEE ALSO 

image(4), ipaste(l), lp(l), snap(l) 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

inet - Internet protocol family 
SYNOPSIS 

#include <sys/types.h> 

#include <netinet/in.h> 

DESCRIPTION 

The Internet protocol family is a collection of protocols layered atop the 
Internet Protocol (IP) transport layer, and utilizing the Internet address for- 
mat. The Internet family provides protocol support for the 
SOCK_STREAM, SOCK_DGRAM, and SOCK_RAW socket types; the 
SOCK_RAW interface provides access to the IP protocol. 

ADDRESSING 

Internet addresses are four byte quantities, stored in network standard for- 
mat. The include file <netinet/in.h> defines this address as a discriminated 
union. 

Sockets bound to the Internet protocol family utilize the following address- 
ing structure, 

struct sockaddr_in { 
short 
u_short 
struct 
char 

}; 

Sockets may be created with the local address INADDR_ANY to effect 
“wildcard” matching on incoming messages. The address in a connect^ 2) 
call may be given as INADDR_ANY to mean “this host.” The dis- 
tinguished address INADDR_BROADCAST is allowed as a shorthand for 
the broadcast address on the primary network if the first network configured 
supports broadcast. 

PROTOCOLS 

The Internet protocol family is comprised of the IP transport protocol, Inter- 
net Control Message Protocol (ICMP), Transmission Control Protocol 
(TCP), and User Datagram Protocol (UDP). TCP is used to support the 
SOCK_STREAM abstraction while UDP is used to support the 
SOCK_DGRAM abstraction. A raw interface to IP is available by creating 
an Internet socket of type SOCK_RAW. The ICMP message protocol is 
accessible from a raw socket. 

The 32-bit Internet address contains both network and host parts. It is 
frequency-encoded; the most-significant bit is clear in Class A addresses, in 
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which the high-order 8 bits are the network number. 

Class B addresses use the high-order 16 bits as the network field, and Class 
C addresses have a 24-bit network part. Sites with a cluster of local net- 
works and a connection to the DARPA Internet may chose to use a single 
network number for the cluster; this is done by using subnet addressing. 
The local (host) portion of the address is further subdivided into subnet and 
host parts. Within a subnet, each subnet appears to be an individual net- 
work; externally, the entire cluster appears to be a single, uniform network 
requiring only a single routing entry. Subnet addressing is enabled and 
examined by the following ioctl( 2) commands on a datagram socket in the 
Internet domain; they have the same form as the SIOCIFADDR command. 

SIOCSIFNETMASK Set interface network mask. The network mask 
defines the network part of the address; if it con- 
tains more of the address than the address type 
would indicate, then subnets are in use. 

SIOCGIFNETMASK Get interface network mask. 

SEE ALSO 

ioctl(2), socket(2), tcp(7P), udp(7P), ip(7P) 

CAVEAT 

The Internet protocol support is subject to change as the Internet protocols 
develop. Users should not depend on details of the current implementation, 
but rather the services exported. 

NOTE 

To compile and link a program that use sockets, follow the procedures for 
section (3B) routines as described in intro( 3). 

ORIGIN 

4.3BSD 
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NAME 

ip - Internet Protocol 
SYNOPSIS 

#include <sys/socket.h> 

#include <netinet/in.h> 

s = socket(AF_INET, SOCK RAW, proto); 

DESCRIPTION 

IP is the transport layer protocol used by the Internet protocol family. 
Options may be set at the IP level when using higher-level protocols that 
are based on IP (such as TCP and UDP). It may also be accessed through a 
“raw socket” when developing new protocols, or special purpose applica- 
tions. 

A single generic option is supported at the IP level, IP_OPTIONS, that may 
be used to provide IP options to be transmitted in the IP header of each out- 
going packet. Options are examined with getsockoptil). The format of IP 
options to be sent is that specified by the IP protocol specification, with one 
exception: the list of addresses for Source Route options must include the 
first-hop gateway at the beginning of the list of gateways. The first-hop 
gateway address will be extracted from the option list and the size adjusted 
accordingly before use. IP options may be used with any socket type in the 
Internet family. 

Raw EP sockets are connectionless, and are normally used with the sendto 
and recvfrom calls, though the connect (2) call may also be used to fix the 
destination for future packets (in which case the read (2) or recv(2) and 
write (2) or send (2) system calls may be used). 

If proto is 0, the default protocol IPPROTO_RAW is used for outgoing 
packets, and only incoming packets destined for that protocol are received. 
If proto is non-zero, that protocol number will be used on outgoing packets 
and to filter incoming packets. 

Outgoing packets automatically have an IP header prepended to them 
(based on the destination address and the protocol number the socket is 
created with). Incoming packets are received with IP header and options 
intact. 

DIAGNOSTICS 

A socket operation may fail with one of the following errors returned: 

[EISCONN] when trying to establish a connection on a socket which 
already has one, or when trying to send a datagram with 
the destination address specified and the socket is already 
connected; 
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[ENOTCONN] when trying to send a datagram, but no destination 
address is specified, and the socket hasn’t been con- 
nected; 

[ENOBUFS] when the system runs out of memory for an internal data 
structure; 

[EADDRNOTAVAIL] 

when an attempt is made to create a socket with a net- 
work address for which no network interface exists. 


The following errors specific to IP may occur when setting or getting IP 
options: 

[EINVAL] An unknown socket option name was given. 

[EDSTVAL] The IP option field was improperly formed; an option 

field was shorter than the minimum value or longer than 
the option buffer provided. 

NOTE 

To compile and link a program that uses sockets, follow the procedures for 
section (3B) routines as described in intro( 3). 


SEE ALSO 

getsockopt(2), send(2), recv(2), intro(3), icmp(7P), inet(7P) 

ORIGIN 

4.3BSD 
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NAME 

ips, dkip - Interphase disk controllers and driver. 

SYNOPSIS 

/dev/dsk/ips* 

/dev/rdsk/ips* 

DESCRIPTION 

The IRIS-4D system supports four types of Interphase disk controller: the 
3201 and 4201 ESDI controllers, and the 4200 and 4400 SMD controllers. 
The 3201 and 4200 support up to two drives per controller, the 4201 and 
4400 support up to 4 drives per controller. A system may contain a max- 
imum of 2 Interphase controllers; types may be mixed. 

The special files are named according to the convention discussed in 
intro (1M): 

/dev/{r}dsk/ips<controller-#>d<drive-#>{s<partition-#>|vh|vol} 

Controller numbers run from 0 to 1 for the two possible controllers in a sys- 
tem. Drive numbers run from 0 to 1 for the 3201 and 4200, and from 0 to 3 
for the 4201 and 4400. 

There is one common kernel driver, referred to as dkip, for all the Inter- 
phase controllers. 

IOCTL FUNCTIONS 

As well as normal read and write operations, the driver supports a number 
of special io control (ioctl) operations when opened via the character spe- 
cial file in /dev/rdsk. These may be invoked from a user program by the 
ioctl system call, see ioctl(2). Command values for these are defined in the 
system include file <sys/dkio.h>. 

These ioctl operations are intended for the use of special-purpose disk utili- 
ties. Many of them can have drastic or even fatal effects on disk operation 
if misused; they should be invoked only by the knowledgeable and with 
extreme caution! 

A list of the ioctl commands supported by the dkip driver is given below. 
DIOCGETVH 

reads the disk volume header from the driver into a buffer in the 
calling program. The arg in the ioctl call is expected to point to a 
buffer of size at least 512 bytes. The structure of the volume 
header is defined in the include file <sys/dvh.h>. 
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DIOCHANDSHAKE 

reads identifying data from the controller firmware into a buffer in 
the calling program. The arg of the iocd call should point to a 
buffer at least 16 bytes long. The structure of the identifying data 
is defined in the include file <sys/dkipreg.h>. 

DIOCRAWREAD 

This is something of a misnomer; what it actually does is to invoke 
a controller command for reading the flawmap information placed 
on the disk by the original manufacturer in accordance with the 
ESDI or SMD specification (depending on disk type). The amount 
of data returned to the calling program is always 512 bytes and the 
program must provide a buffer of this size to receive it. The 
operation is controlled by a structure which must be pointed to by 
the arg of the ioctl call; this is a ’struct rawread_info’ which is 
defined in <sys/dvh.h>. Flawmaps are always at the start of tracks, 
however for historical reasons the identifying argument is an abso- 
lute blocknumber rather than a cylinder/head specification. Thus it 
is necessary to know the geometry of the disk in order to construct 
the arguments. For the interpretation of the returned data, see 
ESDI or SMD interface specifications. 

DIOCCDCRAW 

is a variant of the previous command for use on CDC disks where 
the way in which the defect information is recorded differs slightly 
from other manufacturers. 

DIOCSENSE 

causes the Unit Initialization Block used by the controller for the 
current drive to be printed on the system console. This contains 
disk geometry and format parameters, the structure members are 
defined in <sys/dkipreg.h>. 

The remaining commands should be used with extreme caution, 
since misuse can render a disk at least temporarily unreadable, or 
at worst destroy data on the disk. 

DIOCSETVH 

transfers a new volume header into the driver, and causes the disk 
drive to be reconfigured in accordance with the parameters in the 
new volume header. The arg in the ioctl call is expected to point 
to a buffer containing a valid volume header with parameters 
appropriate for the drive. 
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DIOCFMTMAP 

formats a track on the disk, or maps a track to a replacement track, 
according to information passed in a buffer pointed to by the arg of 
the ioctl call. The arg should point to a ’struct fmt_map_info’, 
which is defined in the include file <sys/dvh.h>. Note that 
although this contains definitions for a number of other possible 
actions, only formatting a track and mapping a track are currently 
supported. The track(s) to be acted on must be specified in the 
form of cylinder/head numbers, and these are absolute numbers 
starting from the beginning of the disk (that is to say, NOT from 
start of the currently open partition). 

FILES 

/dev/dsk/ips* 

/dev/rdsk/ips* 

/usr/include/sys/dkio.h /usr/include/sys/dvh.h/usr/include/sys/dkipreg.h 

BUGS 

For historical reasons, the names of the ioctls are not always logical, and 
their arguments are an irregular mess. 

DIOCSENSE should probably have an option to return data to the caller 
rather than always printing on the system console. 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

keyboard - keyboard specifications 

DESCRIPTION 

OVERVIEW 

The keyboard is an up-down encoded 101 key keyboard. 

The keyboard connects to the main electronics cabinet through a shielded 
partially coiled cord, and is detachable at the system cabinet only. The opti- 
cal mouse plugs into either side of the keyboard. Ports are provided on both 
sides of the enclosure to allow access to left-handed and right-handed 
mouse connectors. The keyboard cord contains low voltage direct current 
power feeds and two serial links; one for the mouse and one for the key- 
board. The keyboard serial link is bidirectional, allowing for control of 
indicator lights and other keyboard functions. Each time a key is pressed or 
released, a code is sent via the keyboard serial link. Every key has a dif- 
ferent upcode and downcode. All keys function the same way, allowing the 
system software to use keys in any manner. Auto-repeat is the only func- 
tion that treats keys differendy. When auto-repeat is enabled, a subset of 
the keys will repeat when held down. Multiple key presses/releases result 
in all key transitions being reported. 

ELECTRICAL INTERFACE 

The keyboard serial I/O interface uses RS423 levels and communicates 
asynchronously to the system at 600 baud. The format used is one start bit 
followed by eight data bits, an odd parity bit and one stop bit, with one byte 
sent per key up or down transition. The idle state and true data bits for the 
interface are Mark level or -5V, whereas false data bits and the start bit are 
spaces or +5V. The pin assignments for the mouse port connector are 
shown in the following table: 


MOUSE PORTS 

PIN 

SIGNAL 

1 

+5V 

9 

GND 

5 

MTXD 

3 

-5V 
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The pin assignments for the keyboard connector are shown in the following 
table: 


KYBD CABLE PINOUT 

Signal 

Pin 

GND 

1 

KTXD 

4 

KRCD 

5 

MTXD 

10 

Reserved 

11 

Reserved 

12 

+12Vdc 

7 

+12Vdc 

8 

GND 

2 

GND 

3 

-12Vdc 

15 

+12Vdc 

9 


SOFTWARE INTERFACE 

The interface between the keyboard and the system is 600 baud asynchro- 
nous. The format used is one start bit followed by eight data bits, an odd 
parity bit and one stop bit, with one byte sent per key up or down transition. 
The MSB of the byte is a "0" for a downstroke and a "1" for an upstroke. 
Control bytes are sent to the keyboard with the same speed and format. The 
system software does all the processing needed to support functions such as 
capitalization, control characters, and numeric lock. Auto-repeat for a 
specified set of characters can be turned on or off by the system software by 
sending a control byte to the keyboard. When auto-repeat is enabled a 
pressed key will begin auto-repeating after 0.65 seconds and repeat 28 
times per second. The keyboard initializes upon power-up. The 
configuration request control byte causes the keyboard to send a two-byte 
sequence to the system. The second byte contains the eight-bit value set on 
a DIP switch in the keyboard. All keyboard lights are controlled by the sys- 
tem software by sending control bytes to the keyboard to turn them on or 
off. Control bytes are also used for long and short beep control and key 
click disable. When key click is enabled, the keys click when they are 
pressed. The long beep duration is 1 second and the short beep duration is 
0.2 second. There are four general-purpose keyboard lights labeled LI 
through L4 and three lights labeled NUM LOCK, CAPS LOCK, and 
SCROLL LOCK. The required keycode mappings and control byte formats 
are shown in the following tables. Note that the legend names prefixed by 
two asterisks are reserved, and not implemented on the keyboard. Legend 
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names prefixed by two exclamation marks do NOT have the auto-repeat 
enable capability. Legend names prefixed by two dollar signs do NOT 
have the key click enable capability. 
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LEGENDS VS KEYCODES IN DECIMAL 

Legend 

Code 

**!!BREAKKEY 

0 

**!!SETUPKEY 

1 

$$!!LEFTCTRL 

2 

$$! ! CAPSLOCKKEY 

3 

$$! ! RIGHTS HIFTKEY 

4 

$$! iLEFTSHIFTKEY 

5 

** ! 1NOSCRLKEY 

12 

! IESCKEY 

6 

HTABKEY 

8 

RETURN.ENTER 

50 

SPACEKEY 

82 

**LINEFEEDKEY 

59 

BACKSPACEKEY 

60 

DELKEY 

61 

SEMICOLONKEY 

42 

PERIODKEY 

51 

COMMAKEY 

44 

QUOTEKEY" 

49 

ACCENTGRAVEKEY' 

54 

MINUSKEY 

46 

VIRGULEKEY? 

52 

BACKSLASHKEY 

56 

EQUALKEY 

53 

LEFTBRACKETKEY 

48 

RIGHTBRACKETKEY 

55 

LEFTARROWKEY 

72 

DOWNARROWKEY 

73 

RIGHT ARROWKEY 

79 

UPARROWKEY 

80 

PADO 

58 

PAD1 

57 

PAD2 

63 

PAD3 

64 

PAD4 

62 

PAD5 

68 

PAD6 

69 
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LEGENDS VS KEYCODES IN DECIMAL 

Legend 

Code 

PAD7 

66 

PAD8 

67 

PAD9 

74 

**PADPF1 

71 

**PADPF2 

70 

**PADPF3 

78 

**PADPF4 

77 

PADPERIOD 

65 

PADMINUS 

75 

* *P ADCOMMA 

76 

MPADENTER 

81 

$$!!LEFTALT 

83 

$$!!RIGHTALT 

84 

$$! 1RIGHTCTRL 

85 

FI 

86 

F2 

87 

F3 

88 

F4 

89 

F5 

90 

F6 

91 

F7 

92 

F8 

93 

F9 

94 

F10 

95 

Fll 

96 

F12 

97 

! ! PRINT. SCREEN 

98 

$$ ! ! S CROLL.LOCK 

99 

HPAUSE 

100 

!! INSERT 

101 

HHOME 

102 

! [PAGEUP 

103 

HEND 

104 

! [PAGEDOWN 

105 

$$!!NUM.LOCK 

106 

PAD.BKSLASH/ 

107 
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LEGENDS VS KEYCODES IN DECIMAL 

Legend 

Code 

PAD.ASTER* 

108 

PAD.PLUS+ 

109 

config byte(lst of 2 bytes) 

110 

config byte(2nd of 2 bytes) 

DIP SW 

GERlessThan 

111 

spare 1 

112 

spare2 

113 

spare3 

114 

spare4 

115 

spare6 

117 

spare7 

118 

spare8 

119 

spare9 

120 

spare 10 

121 
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KEYCODES IN DECIMAL VS LEGENDS 

Code 

Legend 

0 

**BREAKKEY 

1 

**! 1SETUPKEY 

2 

$$!!LEFTCTRL 

3 

$$! 1CAPSLOCKKEY 

4 

$$!!RIGHTSHIFTKEY 

5 

$$! ILEFTSHIFTKEY 

6 

UESCKEY 

7 

ONEKEY 

8 

MTABKEY 

9 

QKEY 

10 

AKEY 

11 

SKEY 

12 

**!!NOSCRLKEY 

13 

TWOKEY 

14 

THREEKEY 

15 

WKEY 

16 

EKEY 

17 

DKEY 

18 

FKEY 

19 

ZKEY 

20 

XKEY 

21 

FOURKEY 

22 

FIVEKEY 

23 

RKEY 

24 

TKEY 

25 

GKEY 

26 

HKEY 

27 

CKEY 

28 

VKEY 

29 

SIX KEY 

30 

SEVENKEY 

31 

YKEY 

32 

UKEY 

33 

JKEY 

34 

KKEY 

35 

BKEY 
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KEYCODES IN DECIMAL VS LEGENDS 

Code 

Legend 

36 

NKEY 

37 

EIGHTKEY 

38 

NINEKEY 

39 

IKEY 

40 

OKEY 

41 

LKEY 

42 

SEMICOLONKEY 

43 

MKEY 

44 

COMMAKEY 

45 

ZEROKEY 

46 

MINUSKEY 

47 

PKEY 

48 

LEFTBRACKET 

49 

QUOTE KEY 

50 

RETURN.ENTER 

51 

PERIODKEY 

52 

VIRGULEKEY 

53 

EQUALKEY 

54 

ACCENTGRAVEKEY 

55 

RIGHTBRACKETKEY 

56 

BACKSLASHKEY 

57 

PADONEKEY 

58 

PADZEROKEY 

59 

* *LINEFEEDKE Y 

60 

BACKSPACEKEY 

61 

DELETEKEY 

62 

PADFOURKEY 

63 

PADTWOKEY 

64 

PADTHREEKEY 

65 

PADPERIODKEY 

66 

PADSEVENKEY 

67 

PADEIGHTKEY 

68 

PADFIVEKEY 

69 

PADSIXKEY 

70 

**PADPF2KEY 

71 

**PADPF1KEY 
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KEYCODES IN DECIMAL VS LEGENDS 

Code 

Legend 

72 

LEFTARROWKEY 

73 

DOWNARROWKEY 

74 

PADNINEKEY 

75 

PADMINUSKEY 

76 

**PADCOMMAKEY 

77 

**PADPF4KEY 

78 

**PADPF3KEY 

79 

RIGHT ARROWKEY 

80 

UPARROWKEY 

81 

! ! PADENTERKE Y 

82 

SPACEKEY 

83 

$$!!LEFTALT 

84 

$$!!RIGHTALT 

85 

$$!!RIGHTCTRL 

86 

FI 

87 

F2 

88 

F3 

89 

F4 

90 

F5 

91 

F6 

92 

F7 

93 

F8 

94 

F9 

95 

F10 

96 

Fll 

97 

F12 

98 

UPRINT.SCREEN 

99 

$$ ! ! SCROLL.LOCK 

100 

!! PAUSE 

101 

!! INSERT 

102 

!!HOME 

103 

! [PAGEUP 

104 

HEND 

105 

! [PAGEDOWN 

106 

$$ ! [NUM.LOCK 

107 

PAD.BKSLASH/ 
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KEYCODES IN DECIMAL VS LEGENDS 

Code 

Legend 

108 

109 

110 

DIP SW 

PAD.ASTER* 
PAD.PLUS+ 
config byte(lst of 2 bytes) 
config byte(2nd of 2 bytes) 


CONTROL BYTES RECOGNIZED BY KEYBOARD 

BIT 

DESCRIPTION 

TRUE 

BIT 0 = 0 

BIT 0 = 1 

1 

short beep 

complement dsl and ds2 

2 

long beep 

ds3 

3 

click disable 

ds4 

4 

return configuration byte 

ds5 

5 

dsl 

ds6 

6 

ds2 

ds7 

7 

enable auto-repeat 

not used 


DISPLAY LABELS 

DISPLAY DESIGNATION 

LABEL 

dsl 

NUMLOCK 

ds2 

CAPS LOCK 

ds3 

SCROLL LOCK 

ds4 

LI 

ds5 

L2 

ds6 

L3 

ds7 

L4 
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NAME 

mem, kmem, mmem - core memory 
DESCRIPTION 

The file /dev/mem is a special file that is an image of the core memory of 
the computer. It may be used, for example, to examine, and even to patch 
the system. 

Byte addresses in /dev/mem are interpreted as memory addresses. Refer- 
ences to non-existent locations cause errors to be returned. 

Examining and patching device registers is likely to lead to unexpected 
results when read-only or write-only bits are present. 

The file tdev/kmem is the same as /dev/mem except that kernel virtual 
memory rather than physical memory is accessed. 

The file /dev/mmem is the same as /dev/kmem when reading and writing. In 
addition, certain addresses can be mapped into the user’s address space via 
mmap(2). These addresses will vary depending on the hardware drivers 
present on any particular system. 

FILES 

/dev/mem 

/dev/kmem 

/dev/mmem 

WARNING 

Some of /dev/kmem cannot be read because of write-only addresses or une- 
quipped memory addresses. 

ORIGIN 

AT&T V.3 
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NAME 

mouse - optical mouse specifications 
DESCRIPTION 

Signals: The serial data interface signal level is compatible with RS-423 
which has roughly a 10V swing centered about ground. The idle state and 
true data bits for the interface are Mark level or -5V whereas false data bits 
and the start bit are spaces or +5V. The serial data is transmitted at 4800 
baud with one start bit, eight data bits, and no parity. 

Protocol: The mouse provides a five-byte data block whenever there is a 
change of position or button state. The first byte is a sync byte which has 
its upper five bits set to 10000 and its lower three bits indicating the button 
states where a 0 indicates depression. The sync byte looks like this: 
10000LMR. The next four bytes contain two difference updates of the 
mouse’s change in position: XI, Yl, X2, and Y2. Positive values indicate 
movement to the right or upward. System software ignores bytes beyond 
the first five until reception of the next sync byte. 

Connector Pin Assignment: 


PIN 

SIGNAL 

1 

+5V 

9 

GND 

5 

MTXD 

3 

-5V 
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NAME 

mtio - magnetic tape interface 
DESCRIPTION 

This page describes the generic interface provided for dealing with the vari- 
ous types of magnetic tape drives supported on the IRIS-4D. Both 1/4" 
streaming cartridge tapes (see ts(T) and tps(l)) and 1/2" nine-track tapes 
(see are supported. 

Tape drives are accessed through special device files in the Idevlmtl* and 
/dev/rmt/* directory. Refer to intro(l) for a general description of the nam- 
ing conventions for device files in theses subdirectories. Naming conven- 
tions for the specific devices are fisted under tps(l), and xmt(7). 

Normally the device specific name is finked to a user friendly synonym for 
ease of use. Many commands that manipulate magnetic tape refer to these 
synonyms rather than device specific names. There are four (4) user 
friendly device synonyms: 

/dev/tape This synonym represents the tape unit that is con- 

sidered to be the system tape drive. It is finked to 
one of the specific device names from ts( 7), tps(l) 
or xmt(l). The device this name represents, 
rewinds the tape when closed and swaps the bytes 
during transfers. 

/dev/nr tape This synonym also represents the tape unit that is 

considered to be the system tape drive. However, 
in this case the device this name represents does 
not rewind the tape; byte swapping during 
transfers still occurs. 

/dev/tapens This synonym is similar to /dev/tape except no 

byte swapping occurs during transfers. 

/dev/nrtapens This synonym is similar to /dev/nrtape except no 

byte swapping occurs during transfers. 

The standard quarter inch tape consists of a series of 512 byte records ter- 
minated by an end-of-file. A tape is normally open for reading and/or writ- 
ing, but a tape cannot be read and written simultaneously. For example, if a 
tape is opened for reading and writting and a read is the first operation, 
writes cannot be performed until the tape is closed and reopened. Similary, 
if a write is the first operation a read cannot be performed until the tape is 
closed and reopened. 

The system makes it possible to treat the tape like any other file. Seeks do 
not have their usual meaning and it is not possible to read or write other 
than a multiple of 512 bytes at a time. Writing in very small blocks (less 
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than 4096 bytes) is inadvisable because this tends to consume more tape 
(create large record gaps verses data) and causes the tape to stop its’ 
streaming motion. 

The half-inch tape drive is written in block sizes of up to 32 KBytes blocks. 
The half-inch tape drive is a standard start stop device. 

The mt( 1) program can be used to manipulate the tape when it is desired to 
access the tape in a way compatible with ordinary files, mt normally 
accesses the system tape synonym: Idev/nrtape. However, it is possible to 
tell it to use any of special files in /dev/m t/* or /dev/rmt/*. A number of 
ioctl operations are available on raw magnetic tape. Refer to mt( 1) for addi- 
tional information. 

The following definitions are from lusrlincludelsyslmtio.h : 

/* 

* Structures and definitions for mag tape io control commands 
*/ 

/* structure for MTIOCTOP - mag tape op command */ 


struct 

mtop 

{ 



short 

mt_ 

_op; /* operations defined below */ 

); 

daddr_t 

mt_count;/* how many of them */ 

/* operations */ 




#define 

MTWEOF 

0 

/* write an end-of-file record */ 

#define 

MTFSF 

1 

/* forward space file */ 

#define 

MTBSF 

2 

/* backward space file */ 

#define 

MTFSR 

3 

/* forward space record */ 

#define 

MTBSR 

4 

/* backward space record */ 

#define 

MTREW 

5 

/* rewind */ 

#define 

MTOFFL 

6 

/* off-line */ 

#define 

MTNOP 

7 

/* no operation, sets status only */ 

#define 

MTRET 

8 

/* retension the tape */ 

#define 

MTRST 

9 

/* reset operation */ 

/* structure for MTIOCGET - 

mag tape get status command */ 

struct 

mtget 

{ 



short 

mt_type;/* type of magtape device */ 

/* the following two registers are very device dependent */ 


short 

mt_dsreg; /* ’drive status’ register */ 


short 

mt_ 

_erreg; /* ’error’ register */ 


/* end device-dependent registers */ 

short mt_resid; /* residual count */ 
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/* the following two are not yet implemented */ 

daddr_t mt_fileno; /*file number of current position*/ 

daddr_t mt_blkno; /*block number of current position*/ 

/* end not yet implemented */ 

}; 

/* 

* Constants for mt_type byte 
*/ 

#define MTJSQIC 0x01 

#define MTJSXM 

#define MTJSSCSI 0x09 

/* mag tape io control commands */ 

#define MTIOCODE(x) (’t’«8l(x)) 

#define MTIOCTOP MTIOCODE(’a’)/* perform tape op */ 

#define MTIOCGET MTIOCODE(’b’)/* get tape status */ 

#define MTIOCGETBLKSIZE MTIOCODE(’c’)/* get tape block size */ 

#define MTSCSIINQ MTIOCODE(’d’)/* return SCSI inquiry data */ 


/* qic-02 tape controller */ 

0x08/* Xylogics magtape */ 

/* Western Digital SCSI controller */ 


Each read or write call uses the next record on the tape. 


FILES 

/dev/tape 


/dev/nrtape 


/dev/tapens 


/dev/nrtapens 


Synonym for system tape with rewind and byte 
swapping 

Synonym for system tape with no-rewind and byte 
swapping 

Synonym for system tape with rewind and no byte 
swapping 

Synonym for system tape with no-rewind and no 
byte swapping 


SEE ALSO 

mt(l), cpio(l), tar(l), ts(7m), tps(7m), xmt(7m) 

ORIGIN 

4.3BSD 


September 1988 


-3- 


Version 3.0 



NULL(7) 


Silicon Graphics 


NULL(7) 


NAME 

null - the null file 
DESCRIPTION 

Data written on the null special file, /dev/null, is discarded. 
Reads from a null special file always return 0 bytes. 

FILES 

/dev/null 

ORIGIN 

AT&T V.3 
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NAME 

pip - parallel line printer interface 

SYNOPSIS 

/dev/plp 

DESCRIPTION 

The special file Idevlplp refers to the parallel printer interface on the IRIS 
4D/20. The pip device supports output to a Centronics-compatible printer 
connected to the builtin parallel printer port. Normally, Idevlplp is directly 
accessed only by a print spooling mechanism such as the lp(l) subsystem. 

The special file Idevlplp may only be open for writing by one process at a 
time. However, several processes may open the device read-only so as to 
obtain printer status. A printer reset (INPUT PRIME) is issued whenever 
the device is opened for writing. 

The following ioctls are defined in the include file <sys/plp.h> and may be 
used to control the device: 

PLPIOCSTATUS Returns the current printer status. 

PLPIOCRESET Cancels any current printing and 

asserts the "INPUT PRIME" signal to 
the printer. 

The printer status ioctl takes as an argument a pointer to an integer in which 
the printer status is placed. Constants defined in <sys/plp.h> describe the 
following status bits: 


BUSY 

FAULT 

EOI 

EOP 

ONLINE 


The printer is currently printing 
Printer is in fault state 
End of Ink (Ribbon out) 

End of Paper 
Printer is on line 


Not all printers support all of these status indications. 

FILES 

/dev/plp 
SEE ALSO 

lp(l) 

ORIGIN 

Silicon Graphics, Inc. 


September 1988 


- 1 - 


Version 3.0 



PRF(7) 


Silicon Graphics 


PRF(7) 


NAME 

prf - operating system profiler 
DESCRIPTION 

The special file Idevlprf provides access to activity information in the 
operating system. Writing the file loads the measurement facility with text 
addresses to be monitored. Reading the file returns these addresses and a 
set of counters indicative of activity between adjacent text addresses. 

The recording mechanism is driven by a separate profiling clock. The 
profiling clock period is set so that it does not become synchronized with 
the regular system clock. Samples that catch the operating system are 
matched against the stored text addresses and increment corresponding 
counters for later processing. 

The file Idevlprf is a pseudo-device with no associated hardware. 

FILES 

/dev/prf 

SEE ALSO 

profiler(lM). 

ORIGIN 

AT&T V.3 
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NAME 

pty - pseudo terminal driver 
DESCRIPTION 

The pty driver provides a device-pair termed a pseudo terminal. A pseudo 
terminal is a pair of character devices, a master device and a slave device. 
The slave device provides processes an interface identical to that described 
in termio(l). However, whereas all other devices which provide the inter- 
face described in termio(l) have a hardware device of some sort behind 
them, the slave device has, instead, another process manipulating it through 
the master half of the pseudo terminal. That is, anything written on the 
master device is given to the slave device as input and anything written on 
the slave device is presented as input on the master device. 

The following ioctl calls apply only to pseudo terminals: 

TIOCPKT 

Enable/disable packet mode. Packet mode is enabled by specify- 
ing (by reference) a nonzero parameter and disabled by specifying 
(by reference) a zero parameter. When applied to the master side 
of a pseudo terminal, each subsequent read from the terminal will 
return data written on the slave part of the pseudo terminal pre- 
ceded by a zero byte (symbolically defined as TIOCPKT_DATA), 
or a single byte reflecting control status information. In the latter 
case, the byte is an inclusive-or of zero or more of the bits: 

TIOCPKT_FLUSHREAD 

whenever the read queue for the terminal is flushed. 

TIOCPKT_FLUS HWRITE 

whenever the write queue for the terminal is flushed. 

TIOCPKT_STOP 

whenever output to the terminal is stopped a la *S. 
TIOCPKT JSTART 

whenever output to the terminal is restarted. 

TIOCPKT_DOSTOP 

whenever t stopc is 'S and t_startc is "Q. 

TIOCPKT_NOSTOP 

whenever the start and stop characters are not 'S/'Q. 

This mode is used by rlogin( 1C) and rlogind( 1M) to implement a 
remote-echoed, locally "S/'Q flow-controlled remote login with 
proper back-flushing of output; it can be used by other similar pro- 
grams. 
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ALLOCATION 

The code sequence shown below demonstrates how to allocate pseudo ter- 
minals. Note that pseudo terminals, like all files, must have the correct file 
permissions to be accessible. 

#include <fcnd.h> 

#include <sys/types.h> 

#include <sys/sysmacros.h> 

#include <sys/stat.h> 

#include <stdio.h> 

/* 

* Find a pseudo tty to use. Fill in "name" with the name of the tty. 

* Return the open descriptor for the controlling side. Caller is 

* responsible for opening the slave side, if it wants to. 

*/ 

int 

fmdPseudoTTY(name, ptynum) 
char *name; 
int *ptynum; 

{ 

int fd; 

struct stat sb; 

fd = open("/dev/ptc", 0_RDWRIO_NDELAY); 
if (fd >= 0) { 

if (fstat(fd, &sb) < 0) { 
close(fd); 
return -1; 

) 

*ptynum = minor(sb.st_rdev); 
sprintf(name, "/dev/ttyq%d", *ptynum); 

} 

return fd; 

} 
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FILES 

/dev/ptc - master pseudo terminal 
/dev/ttyq[0-99] - slave pseudo terminals 

ORIGIN 

4.3BSD 
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NAME 

root, rroot, usr, rusr, swap, rswap - Partition names. 

DESCRIPTION 

These are the device special files providing access to important partitions on 
the root disk drive of the system. The names beginning with ’r’ are the raw 
or ’character’ device access, the others are the block device access which 
uses the kernel buffer system. 

The standard partition allocation by Silicon Graphics has root on partition 
0, swap on partition 1, and /usr on partition 6. Partition 7 maps the entire 
usable portion of the disk (excluding the defect area and volume header). 
Partition 8 maps the volume header (see v/z(7M), prtvtoc{ 1M), 
dvhtool( 1M)). Partition 9 maps the defect area, (where applicable; there is 
no defect area on SCSI drives). Partition 10 maps the entire drive. 

The standard IRIS-4D with ESDI drives has /dev/root linked to 

Zdev/dsk/ipsOdOsO, Idevlswap linked to /dev/dsk/ipsOdOsl , and /dev/ usr 
linked to Idev/dsk/ips0d0s6. 

The standard IRIS-4D with SCSI drives has /dev/root linked to 

Idev/dskldksOdlsO , Idevlswap linked to Idev/dsk/dksOdlsl , and /dev/usr 
linked to Idev/dsk/dks0dls6. 

FILES 

/dev/dsk/ips* 

/dev/rdsk/ips* 

/dev/dsk/dks* 

/dev/rdsk/dks* 

/dev/root 

/dev/usr 

/dev/swap 

SEE ALSO 

dvhtool(lM), prtvtoc(lM), fx(lM), vh(7m). 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

S A - devices administered by System Administration 
DESCRIPTION 

The files in the directories /dev/SA (for block devices) and the /dev/rSA 
(for raw devices) are used by System Administration to access the devices 
on which it operates. For devices that support more than one partition (like 
disks) the /dev/(r)SA entry is linked to the partition that spans the entire 
device. Not all /dev/(r)SA entries are used by all System Administration 
commands. 

FILES 

/dev/SA 

/dev/rSA 

SEE ALSO 

sysadm(l) in the User’s Reference Manual. 

ORIGIN 

AT&T V.3 
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NAME 

smfd - SCSI floppy disk driver 

SYNOPSIS 

/dev/rdsk/fds* 

DESCRIPTION 

This driver supports 5 Vi" floppy drives in 3 standard formats when used 
with the freestanding SCSI floppy drive, and for the Konica K-510 10.7 
Mbyte internal floppy drive. It also supports a large range of special for- 
mats on the freestanding unit by use of the SMFDSETMODE ioctl 
(defined in lusr/includelsyslsmfd.h). 

The standard devices are the standard PC formats of 360K (.48), 720K 
(.96), 1.2 M (,96hi) on the freestanding unit, and the 10.7 Mbyte on the 
Konica drive. 

The special files are named according to the convention discussed in 
intro (1M), with the exception of .type, instead of s#: 

/dev/{r}dsk/fds<controller-#>d<drive-#>{.type) 

These devices are not supported for filesystem use, however they may be 
used as backup devices, and for data interchange with other systems. 

FILES 

/dev/rdsk/fds?d?.48 

/dev/rdsk/fds?d?.96 

/dev/rdsk/fds?d?.96hi 

/dev/rdsk/fds?d?.480 

SEE ALSO 

fx(lM). 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

streamio - STREAMS ioctl commands 
SYNOPSIS 

#include <stropts.h> 

int ioctl (tildes, command, arg) 

int tildes, command; 

DESCRIPTION 

STREAMS [see intro( 2)] ioctl commands are a subset of ioctl( 2) system 
calls which perform a variety of control functions on streams. The argu- 
ments command and arg are passed to the file designated by fildes and are 
interpreted by the stream head. Certain combinations of these arguments 
may be passed to a module or driver in the stream. 

fildes is an open file descriptor that refers to a stream, command deter- 
mines the control function to be performed as described below, arg 
represents additional information that is needed by this command. The type 
of arg depends upon the command, but it is generally an integer or a pointer 
to a command-specific data structure. 

Since these STREAMS commands are a subset of ioctl, they are subject to 
the errors described there. In addition to those errors, the call will fail with 
errno set to EINVAL, without processing a control function, if the stream 
referenced by fildes is linked below a multiplexor, or if command is not a 
valid value for a stream. 

Also, as described in ioctl, STREAMS modules and drivers can detect errors. 
In this case, the module or driver sends an error message to the stream head 
containing an error value. This causes subsequent system calls to fail with 
errno set to this value. 

COMMAND FUNCTIONS 

The following ioctl commands, with error values indicated, are applicable 
to all STREAMS files: 

I_PUSH Pushes the module whose name is pointed to by arg onto 

the top of the current stream, just below the stream head. It 
then calls the open routine of the newly-pushed module. 
On failure, errno is set to one of the following values: 

[EINVAL] Invalid module name. 

[EFAULT] arg points outside the allocated address 
space. 

[ENXIO] Open routine of new module failed. 

[ENXIO] Hangup received on fildes. 
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I_SETSIG 
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Removes the module just below the stream head of the 
stream pointed to by Jildes. arg should be 0 in an I_POP 
request. On failure, errno is set to one of the following 
values: 

[EENVAL] No module present in the stream. 

[ENXIO] Hangup received on jildes. 

Retrieves the name of the module just below the stream 
head of the stream pointed to by jildes, and places it in a 
null terminated character string pointed at by arg. The 
buffer pointed to by arg should be at least FMNAMESZ+1 
bytes long. An [#include <sys/conf.h>] declaration is 
required. On failure, errno is set to one of the following 
values: 

[EFAULT] arg points outside the allocated address 
space. 

[EINVAL] No module present in stream. 

This request flushes all input and/or output queues, depend- 
ing on the value of arg. Legal arg values are: 

FLUSHR Flush read queues. 

FLUSHW Flush write queues. 

FLUSHRW Hush read and write queues. 

On failure, errno is set to one of the following values: 

[ENOSR] Unable to allocate buffers for flush mes- 
sage due to insufficient STREAMS memory 
resources. 

[EINVAL] Invalid arg value. 

[ENXIO] Hangup received on jildes. 

Informs the stream head that the user wishes the kernel to 
issue the SIGPOLL signal [see signal^ 2) and sigset(2)] when 
a particular event has occurred on the stream associated 
with jildes. I_SETSIG supports an asynchronous processing 
capability in STREAMS. The value of arg is a bitmask that 
specifies the events for which the user should be signaled. 
It is the bitwise-OR of any combination of the following 
constants: 

S_INPUT A non-priority message has arrived on a 
stream head read queue, and no other mes- 
sages existed on that queue before this 
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message was placed there. This is set even 
if the message is of zero length. 

S_HIPRI A priority message is present on the stream 

head read queue. This is set even if the 
message is of zero length. 

S_OUTPUT The write queue just below the stream head 
is no longer full. This notifies the user that 
there is room on the queue for sending (or 
writing) data downstream. 

S_MSG A STREAMS signal message that contains 

the SIGPOLL signal has reached the front of 
the stream head read queue. 

A user process may choose to be signaled only of priority 
messages by setting the arg bitmask to the value S_HIPRI. 

Processes that wish to receive SIGPOLL signals must expli- 
citly register to receive them using I_SETSIG. If several 
processes register to receive this signal for the same event 
on the same Stream, each process will be signaled when the 
event occurs. 

If the value of arg is zero, the calling process will be unre- 
gistered and will not receive further SIGPOLL signals. On 
failure, errno is set to one of the following values: 

[EINVAL] arg value is invalid or arg is zero and pro- 
cess is not registered to receive the SIG- 
POLL signal. 

[EAGAIN] Allocation of a data structure to store the 
signal request failed. 

I_GETSIG Returns the events for which the calling process is currently 
registered to be sent a SIGPOLL signal. The events are 
returned as a bitmask pointed to by arg, where the events 
are those specified in the description of I_SETSIG above. 
On failure, errno is set to one of the following values: 

[EINVAL] Process not registered to receive the SIG- 
POLL signal. 

[EFAULT] arg points outside the allocated address 
space. 

I_FIND Compares the names of all modules currently present in the 

stream to the name pointed to by arg, and returns 1 if the 
named module is present in the stream. It returns 0 if the 
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I_PEEK 


I_SRDOPT 


named module is not present. On failure, errno is set to one 
of the following values: 

[EFAULT] arg points outside the allocated address 
space. 

[EINVAL] arg does not contain a valid module name. 

Allows a user to retrieve the information in the first mes- 
sage on the stream head read queue without taking the mes- 
sage off the queue, arg points to a strpeek structure which 
contains the following members: 

struct strbuf ctlbuf; 

struct strbuf databuf; 

long flags; 

The maxlen field in the ctlbuf and databuf strbuf structures 
[see getmsg( 2)] must be set to the number of bytes of con- 
trol information and/or data information, respectively, to 
retrieve. If the user sets flags to RS_HIPRI, I_PEEK will 
only look for a priority message on the stream head read 
queue. 

I_PEEK returns 1 if a message was retrieved, and returns 0 
if no message was found on the stream head read queue, or 
if the RS_HIPRI flag was set in flags and a priority message 
was not present on the stream head read queue. It does not 
wait for a message to arrive. On return, ctlbuf specifies 
information in the control buffer, databuf specifies informa- 
tion in the data buffer, and flags contains the value 0 or 
RS_HIPRI. On failure, errno is set to the following value: 

[EFAULT] arg points, or the buffer area specified in 
ctlbuf or databuf is, outside the allocated 
address space. 

[EBADMSG] Queued message to be read is not valid for 
I_PEEK 

Sets the read mode using the value of the argument arg. 
Legal arg values are: 

RNORM Byte-stream mode, the default. 

RMSGD Message-discard mode. 

RMSGN Message-nondiscard mode. 

Read modes are described in read{ 2). On failure, errno is 
set to the following value: 
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IJ3RDOPT 


I_NREAD 


I_FDINSERT 


[EINVAL] arg is not one of the above legal values. 

Returns the current read mode setting in an int pointed to 
by the argument arg. Read modes are described in read( 2). 
On failure, errno is set to the following value: 

[EFAULT] arg points outside the allocated address 
space. 

Counts the number of data bytes in data blocks in the first 
message on the stream head read queue, and places this 
value in the location pointed to by arg. The return value 
for the command is the number of messages on the stream 
head read queue. For example, if zero is returned in arg, 
but the ioctl return value is greater than zero, this indicates 
that a zero-length message is next on the queue. On failure, 
errno is set to the following value: 

[EFAULT] arg points outside the allocated address 
space. 

Creates a message from user specified buffer(s), adds infor- 
mation about another stream and sends the message down- 
stream. The message contains a control part and an 
optional data part. The data and control parts to be sent are 
distinguished by placement in separate buffers, as described 
below. 

arg points to a strfdinsert structure which contains the fol- 
lowing members: 


struct strbuf 

ctlbuf; 

struct strbuf 

databuf; 

long 

flags; 

int 

fildes; 

int 

offset; 


The len field in the ctlbuf strbuf structure [see putmsg( 2)] 
must be set to the size of a pointer plus the number of bytes 
of control information to be sent with the message, fildes in 
the strfdinsert structure specifies the file descriptor of the 
other stream, offset, which must be word-aligned, specifies 
the number of bytes beyond the beginning of the control 
buffer where I_FDINSERT will store a pointer. This pointer 
will be the address of the read queue structure of the driver 
for the stream corresponding to fildes in the strfdinsert 
structure. The len field in the databuf strbuf structure must 
be set to the number of bytes of data information to be sent 
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with the message or zero if no data part is to be sent. 

flags specifies the type of message to be created. A non- 
priority message is created if flags is set to 0, and a priority 
message is created if flags is set to RS_HIPRI. For non- 
priority messages, I_FDINSERT will block if the stream 
write queue is full due to internal flow control conditions. 
For priority messages, I_FDINSERT does not block on this 
condition. For non-priority messages, I_FDINSERT does 
not block when the write queue is full and OJSIDELAY is 
set. Instead, it fails and sets errno to EAGAIN. 


I_FDINSERT also blocks, unless prevented by lack of inter- 
nal resources, waiting for the availability of message blocks 
in the stream, regardless of priority or whether 0_NDELAY 
has been specified. No partial message is sent. On failure, 
errno is set to one of the following values: 

[EAGAIN] A non-priority message was specified, the 
0_NDELAY flag is set, and the stream 
write queue is full due to internal flow con- 
trol conditions. 


[ENOSR] 


[EFAULT] 


[EINVAL] 


[ENXIO] 

[ERANGE] 


Buffers could not be allocated for the mes- 
sage that was to be created due to 
insufficient STREAMS memory resources. 

arg points, or the buffer area specified in 
ctlbuf or databuf is, outside the allocated 
address space. 

One of the following: fildes in the strfdin- 
sert structure is not a valid, open stream file 
descriptor; the size of a pointer plus offset 
is greater than the len field for the buffer 
specified through ctlptr; offset does not 
specify a properly-aligned location in the 
data buffer; an undefined value is stored in 
flags. 

Hangup received on fildes of the ioctl call 
or fildes in the strfdinsert structure. 

The len field for the buffer specified 
through databuf does not fall within the 
range specified by the maximum and 
minimum packet sizes of the topmost 
stream module, or the len field for the 
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buffer specified through databuf is larger 
than the maximum configured size of the 
data part of a message, or the len field for 
the buffer specified through ctlbuf is larger 
than the maximum configured size of the 
control part of a message. 

I_FDINSERT can also fail if an error message was received 
by the stream head of the stream corresponding to fildes in 
the strfdinsert structure. In this case, errno will be set to 
the value in the message. 

Constructs an internal STREAMS ioctl message from the 
data pointed to by arg, and sends that message downstream. 

This mechanism is provided to send user ioctl requests to 
downstream modules and drivers. It allows information to 
be sent with the ioctl, and will return to the user any infor- 
mation sent upstream by the downstream recipient. I_STR 
blocks until the system responds with either a positive or 
negative acknowledgement message, or until the request 
"times out" after some period of time. If the request times 
out, it fails with errno set to ETIME. 

At most, one I_STR can be active on a stream. Further 
I_STR calls will block until the active I_STR completes at 
the stream head. The default timeout interval for these 
requests is 15 seconds. The 0_NDELAY [see open{ 2)] flag 
has no effect on this call. 

To send requests downstream, arg must point to a strioctl 
structure which contains the following members: 


int 

ic_cmd; 

/* downstream command */ 

int 

ic_timout; 

/* ACK/NAK timeout */ 

int 

ic_len; 

/* length of data arg */ 

char 

*ic_dp; 

/* ptr to data arg */ 


ic_cmd is the internal ioctl command intended for a down- 
stream module or driver and icjimout is the number of 
seconds (-1 = infinite, 0 = use default, >0 = as specified) an 
I_STR request will wait for acknowledgement before timing 
out. ic_len is the number of bytes in the data argument and 
ic dp is a pointer to the data argument. The ic len field has 
two uses: on input, it contains the length of the data argu- 
ment passed in, and on return from the command, it con- 
tains the number of bytes being returned to the user (the 
buffer pointed to by ic_dp should be large enough to 
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contain the maximum amount of data that any module or 
the driver in the stream can return). 


The stream head will convert the information pointed to by 
the striocil structure to an internal ioctl command message 
and send it downstream. On failure, errno is set to one of 
the following values: 

[ENOSR] Unable to allocate buffers for the ioctl mes- 
sage due to insufficient STREAMS memory 
resources. 


[EFAULT] arg points, or the buffer area specified by 
ic_dp and ic_len (separately for data sent 
and data returned) is, outside the allocated 
address space. 

[EINVAL] icjen is less than 0 or icjen is larger than 
the maximum configured size of the data 
part of a message or icjimout is less than 
- 1 . 


[ENXIO] Hangup received on fildes. 

[ETIME] A downstream ioctl timed out before ack- 

nowledgement was received. 

An I_STR can also fail while waiting for an acknowledge- 
ment if a message indicating an error or a hangup is 
received at the stream head. In addition, an error code can 
be returned in the positive or negative acknowledgement 
message, in the event the ioctl command sent downstream 
fails. For these cases, I_STR will fail with errno set to the 
value in the message. 

Requests the stream associated with fildes to send a mes- 
sage, containing a file pointer, to the stream head at the 
other end of a stream pipe. The file pointer corresponds to 
arg, which must be an integer file descriptor. 

LSENDFD converts arg into the corresponding system file 
pointer. It allocates a message block and inserts the file 
pointer in the block. The user id and group id associated 
with the sending process are also inserted. This message is 
placed directly on the read queue [see intro{ 2)] of the 
stream head at the other end of the stream pipe to which it 
is connected. On failure, errno is set to one of the follow- 
ing values: 


Version 3.0 


- 8 - 


September 1988 



STREAMIO(7) 


Silicon Graphics 


STREAMIO(7) 


[EAGAIN] The sending stream is unable to allocate a 
message block to contain the file pointer. 

[EAGAIN] The read queue of the receiving stream 
head is full and cannot accept the message 
sent by I_SENDFD. 

[EBADF] arg is not a valid, open file descriptor. 

[EINVAL] jildes is not connected to a stream pipe. 

[ENXIO] Hangup received on jildes. 

I_RECVFD Retrieves the file descriptor associated with the message 
sent by an I_SENDFD ioctl over a stream pipe, arg is a 
pointer to a data buffer large enough to hold an strrecvfd 
data structure containing the following members: 

int fd; 

unsigned short uid; 
unsigned short gid; 
char fill[8]; 

fd is an integer file descriptor, uid and gid are the user id 
and group id, respectively, of the sending stream. 

If 0_NDELAY is not set [see open{2j], I_RECVFD will 
block until a message is present at the stream head. If 
0_NDELAY is set, I_RECVFD will fail with errno set to 
EAGAIN if no message is present at the stream head. 

If the message at the stream head is a message sent by an 
I_SENDFD, a new user file descriptor is allocated for the file 
pointer contained in the message. The new file descriptor is 
placed in the fd field of the strrecvfd structure. The struc- 
ture is copied into the user data buffer pointed to by arg. 
On failure, errno is set to one of the following values: 

[EAGAIN] A message was not present at the stream 
head read queue, and the 0_NDELAY flag 
is set. 

[EBADMSG] The message at the stream head read queue 
was not a message containing a passed file 
descriptor. 

[EFAULT] arg points outside the allocated address 
space. 

[EMFILE] NOFILES file descriptors are currently 
open. 
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[ENXIO] Hangup received on fildes. 

The following two commands are used for connecting and disconnecting 
multiplexed STREAMS configurations. 

I_LINK Connects two streams, where fildes is the file descriptor of 

the stream connected to the multiplexing driver, and arg is 
the file descriptor of the stream connected to another driver. 
The stream designated by arg gets connected below the 
multiplexing driver. IJLINK requires the multiplexing 
driver to send an acknowledgement message to the stream 
head regarding the linking operation. This call returns a 
multiplexor ID number (an identifier used to disconnect the 
multiplexor, see I_UNLINK) on success, and a -1 on failure. 
On failure, errno is set to one of the following values: 


[ENXIO] 

Hangup received on fildes. 

[ETIME] 

Time out before acknowledgement mes- 
sage was received at stream head. 

[EAGAIN] 

Temporarily unable to allocate storage to 
perform the I_LINK. 

[ENOSR] 

Unable to allocate storage to perform the 
I_LINK due to insufficient STREAMS 


memory resources. 

[EBADF] 

arg is not a valid, open file descriptor. 

[EINVAL] 

fildes stream does not support multiplexing. 

[EINVAL] 

arg is not a stream, or is already linked 
under a multiplexor. 

[EINVAL] 

The specified link operation would cause a 
"cycle" in the resulting configuration; that 
is, if a given stream head is linked into a 
multiplexing configuration in more than 
one place. 


An I_LINK can also fail while waiting for the multiplexing 
driver to acknowledge the link request, if a message indi- 
cating an error or a hangup is received at the stream head 
of fildes. In addition, an error code can be returned in the 
positive or negative acknowledgement message. For these 
cases, I_LINK will fail with errno set to the value in the 
message. 

I_UNLINK Disconnects the two streams specified by fildes and arg. 

fildes is the file descriptor of the stream connected to the 
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multiplexing driver, fildes must correspond to the stream 
on which the ioctl I_LINK command was issued to link the 
stream below the multiplexing driver, arg is the multi- 
plexor ID number that was returned by the I_LINK. If arg 
is -1, then all Streams which were linked to fildes are 
disconnected. As in I_LINK, this command requires the 
multiplexing driver to acknowledge the unlink. On failure, 
errno is set to one of the following values: 

[ENXIO] Hangup received on fildes. 

[ETIME] Time out before acknowledgement mes- 

sage was received at stream head. 

[ENOSR] Unable to allocate storage to perform the 
LUNLINK due to insufficient STREAMS 
memory resources. 

[EINVAL] arg is an invalid multiplexor ID number or 
fildes is not the stream on which the I_LINK 
that returned arg was performed. 

An I_UNLINK can also fail while waiting for the multiplex- 
ing driver to acknowledge the link request, if a message 
indicating an error or a hangup is received at the stream 
head of fildes. In addition, an error code can be returned in 
the positive or negative acknowledgement message. For 
these cases, I_UNLINK will fail with errno set to the value 
in the message. 

SEE ALSO 

close(2), fcntl(2), intro(2), iocd(2), open(2), read(2), getmsg(2), poll(2), 
putmsg(2), signal(2), sigset(2), write(2) in the Programmer’ s Reference 
Manual. 

STREAMS Programmer’ s Guide. 

STREAMS Primer. 

DIAGNOSTICS 

Unless specified otherwise above, the return value from ioctl is 0 upon suc- 
cess and -1 upon failure with errno set as indicated. 
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NAME 

t3270 - Silicon Graphics 3270 interface card 
DESCRIPTION 

This is the driver for the Silicon Graphics 3270 interface card. The card is a 
communication adapter for the connection of a Silicon Graphics 4D system 
to a IBM 3270 Cluster Controller using the 3270 Coax Type A protocol. 

For Control Unit Terminal (CUT) operations, the coax emulation code is 
soft-loaded by the driver onto the card to maintain the session, and to 
manage the contents of the display buffer. 

For Distributed Function Terminal (DFT) operations, the coax emulation 
code is to maintain the communication session, while the driver is responsi- 
ble for the decoding and execution of the SNA data stream. 

The interface between the coax emulation code and the driver is maintained 
as a dual-ported communication memory area, while the interface between 
the driver and the application level emulator (t3270(l)) is through ioctl. 

#include <sys/t3270reg.h> 
di_info_t diaginfo; 

ioctl(fd,UCODE_DLOAD,addr); 
ioctl(fd,START_8344,0); 
ioctl(fd,EM_CTRL,ctrl_word); 
ioctl(fd,SET_DID,id); 
ioctl(fd,START_COMM,0); 
ioctl(fd,STOP_COMM,0); 
ioctl(fd,CUR_UD, cursor); 
ioctl(fd,SCR_UD,scr); 
ioctl(fd,SEND_KEY,key); 
ioctl(fd,BEGIN_MSG,0); 
iocd(fd,STOP_MSG,0); 
ioctl(fd,SEND_MSG,msg_count); 
ioctl(fd,RECV_MSG,addr); 
ioctl(fd,SET_TIME,t); 
ioctl(fd,SELF_TST,&diaginfo); 
iocd(fd,REG_TST,&diaginfo); 
ioctl(fd,DP_MEM_TST,&diaginfo); 
ioctl(fd,IT_MEM_TST,&diaginfo); 

typedef struct { 

u_int patm_w; /* pattern written */ 

u_int pattn_r; /* pattern read */ 

u_short err_addr; /* where error occur */ 

u_char err_flag; /* type of error */ 


/* microcode download */ 

/* start the DP8344 */ 

/* set emulation control */ 

/* set device id */ 

/* start communication */ 

/* stop communication */ 

/* get cursor */ 

/* update screen */ 

/* send key code */ 

/* begin messaging mode */ 
/* stop messaging mode */ 

/* send message */ 

/* receive message */ 

/* set timeout */ 

/* self test */ 

/* register test */ 

/* data memory test */ 

/* instruction memory test */ 
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u_char cycles; 

} di_info_t; 

Only one device file may be opened at a time. 

FILES 

/dev/t3270 

SEE ALSO 

t3270(l) 

ORIGIN 

Silicon Graphics, Inc. 


/* # of test cycle */ 
/* diag info */ 
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NAME 

tcp - Internet Transmission Control Protocol 
SYNOPSIS 

#include <sys/socket.h> 

#include <netinet/in.h> 

s = socket(AF INET, SOCKSTREAM, 0); 

DESCRIPTION 

The TCP protocol provides reliable, flow-controlled, two-way transmission 
of data. It is a byte-stream protocol used to support the SOCK_STREAM 
abstraction. TCP uses the standard Internet address format and, in addition, 
provides a per-host collection of “port addresses”. Thus, each address is 
composed of an Internet address specifying the host and network, with a 
specific TCP port on the host identifying the peer entity. 

Sockets utilizing the tcp protocol are either “active” or “passive”. Active 
sockets initiate connections to passive sockets. By default TCP sockets are 
created active; to create a passive socket the listen( 2) system call must be 
used after binding the socket with the bind( 2) system call. Only passive 
sockets may use the accept (2) call to accept incoming connections. Only 
active sockets may use the connect^ 2) call to initiate connections. 

Passive sockets may “underspecify” their location to match incoming con- 
nection requests from multiple networks. This technique, termed “wildcard 
addressing”, allows a single server to provide service to clients on multiple 
networks. To create a socket which listens on all networks, the Internet 
address INADDR_ANY must be bound. The TCP port may still be 
specified at this time; if the port is not specified the system will assign one. 
Once a connection has been established the socket’s address is fixed by the 
peer entity’s location. The address assigned the socket is the address asso- 
ciated with the network interface through which packets are being transmit- 
ted and received. Normally this address corresponds to the peer entity’s 
network. 

TCP supports one socket option which is tested with getsockopt( 2). Under 
most circumstances, TCP sends data when it is presented; when outstanding 
data has not yet been acknowledged, it gathers small amounts of output to 
be sent in a single packet once an acknowledgement is received. For a 
small number of clients, such as window systems that send a stream of 
mouse events which receive no replies, this packetization may cause 
significant delays. Therefore, TCP provides a boolean option, 
TCP_NODELAY (from <netinet/tcp.h > , to defeat this algorithm. 

Options at the IP transport level may be used with TCP; see ip (IP). Incom- 
ing connection requests that are source-routed are noted, and the reverse 
source route is used in responding. 
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DIAGNOSTICS 

A socket operation may fail with one of the following errors returned: 


[EISCONN] 

[ENOBUFS] 

[ETIMEDOUT] 

[ECONNRESET] 


when trying to establish a connection on a socket 
which already has one; 

when the system runs out of memory for an inter- 
nal data structure; 

when a connection was dropped due to excessive 
retransmissions; 

when the remote peer forces the connection to be 
closed; 


[ECONNREFUSED] when the remote peer actively refuses connection 
establishment (usually because no process is listen- 
ing to the port); 

[EADDRINUSE] when an attempt is made to create a socket with a 
port which has already been allocated; 

[EADDRNOTAVADL] when an attempt is made to create a socket with a 
network address for which no network interface 
exists. 


NOTE 

To compile and link a program that use sockets, follow the procedures for 
section (3B) routines as described in intro( 3). 


SEE ALSO 

getsockopt(2), socket(2), intro(3), inet(7P), ip(7P) 

ORIGIN 

4.3BSD 
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NAME 

termio - general terminal interface 
DESCRIPTION 

All of the asynchronous communications ports use the same general inter- 
face, no matter what hardware is involved. The remainder of this section 
discusses the common features of this interface. 

When a terminal file is opened, it normally causes the process to wait until a 
connection is established. In practice, users’ programs seldom open termi- 
nal files; they are opened by getty and become a user’s standard input, out- 
put, and error files. The very first terminal file opened by the process group 
leader of a terminal file not already associated with a process group 
becomes the control terminal for that process group. The control terminal 
plays a special role in handling quit and interrupt signals, as discussed 
below. The control terminal is inherited by a child process during afork(2). 
A process can break this association by changing its process group using 
setpgrp{ 2). 

When the carrier signal from the data-set drops, a hang-up signal is sent to 
all processes that have this terminal as the control terminal. Unless other 
arrangements have been made, this signal causes the processes to terminate. 
If the hang-up signal is ignored, any subsequent read returns with an end- 
of-file indication. Thus, programs that read a terminal and test for end-of- 
file can terminate appropriately when hung up on. 

A terminal associated with one of these files ordinarily operates in full- 
duplex mode. Characters may be typed at any time, even while output is 
occurring, and are only lost when the system’s character input buffers 
become completely full, which is rare, or when the user has accumulated 
the maximum allowed number of input characters that have not yet been 
read by some program. Currently, this limit is 256 characters. When the 
input limit is reached, the buffer is flushed and all the saved characters are 
thrown away without notice. 

Normally, terminal input is processed in units of lines. A line is delimited 
by a new-line (ASCII LF) character, an end-of-file (ASCII EOT) character, or 
an end-of-line character. This means that a program attempting to read will 
be suspended until an entire line has been typed. Also, no matter how many 
characters are requested in the read call, at most one line will be returned. 
It is not, however, necessary to read a whole line at once; any number of 
characters may be requested in a read, even one, without losing informa- 
tion. 

During input, erase and kill processing is normally done. The erase charac- 
ter erases the last character typed, except that it will not erase beyond the 
beginning of the line. The kill character kills (deletes) the entire input line. 
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and optionally outputs a new-line character. Both these characters operate 
on a key-stroke basis, independently of any backspacing or tabbing that 
may have been done. The erase and kill characters may be changed. 

When one or more characters are written, they are transmitted to the termi- 
nal as soon as previously-written characters have finished typing. Input 
characters are echoed by putting them in the output queue as they arrive. If 
a process produces characters more rapidly than they can be typed, it will 
be suspended when its output queue exceeds some limit. When the queue 
has drained down to some threshold, the program is resumed. 

Several ioctl(2 ) system calls apply to terminal files. The primary calls use 
the following structure, defined in <termio.h>: 


#define 

NCC 

8 



#define 

NCC_PAD 

7 



#define 

NCC_EXT 

16 



struct 

termio { 
unsigned 

short 

c_iflag; 

/* input modes */ 


unsigned 

short 

c_oflag; 

/* output modes */ 


unsigned 

short 

c_cflag; 

/* control modes */ 


unsigned 

short 

cjflag; 

/* local modes */ 


char 


cjine; 

/* line discipline */ 


unsigned 

char 

c_cc [ncc+ncc_pad+ncc_ext] ; 


/* control chars */ 

}; 

The cjine field defines the line discipline used to interpret control charac- 
ters. A line discipline is associated with a family of interpretations. For 
example, LDISCO is the standard System V set of interpretations, while 
LDISC1 is similar to the interpretations used in the 4.3BSD ‘new’ tty driver. 
In LDISC1, 

• additional control characters are available (see below), 

• control characters which are not editing characters are echoed as fol- 
lowed by the equivalent letter, 

• backspacing does not back up into the prompt, and 

• input is re-typed when backspacing encounters a confusion between 
what the user and the computer have typed. 

Certain characters have special functions on input. These functions and 
their default character values are summarized as follows: 

INTR (Rubout or ASCII DEL) generates an interrupt signal which is sent 
to all processes with the associated control terminal. Normally, 
each such process is forced to terminate, but arrangements may be 
made either to ignore the signal or to receive a trap to an agreed- 
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upon location; see signal (2). 

QUIT (ControlA or ASCII FS) generates a quit signal. Its treatment is 
identical to the interrupt signal except that, unless a receiving pro- 
cess has made other arrangements, it will not only be terminated 
but a core image file (called core) will be created in the current 
working directory. 

ERASE (Control-H or backspace) erases the preceding character. It will 
not erase beyond the start of a line, as delimited by a NL, EOF, or 
EOL character. 

KILL (Control-U) deletes the entire line, as delimited by a NL, EOF, or 
EOL character. 

EOF (Control-D or ASCII EOT) may be used to generate an end-of-file 
from a terminal. When received, all the characters waiting to be 
read are immediately passed to the program, without waiting for a 
new-line, and the EOF is discarded. Thus, if there are no charac- 
ters waiting, which is to say the EOF occurred at the beginning of 
a line, zero characters will be passed back, which is the standard 
end-of-file indication. 

NL (ASCH LF) is the normal line delimiter. It can not be changed or 
escaped. 

EOL (ASCH NUL) is an additional line delimiter, like NL. It is not nor- 
mally used. 

EOL2 is another additional line delimiter. 

STOP (Control- S or ASCII DC3) can be used to temporarily suspend out- 
put. It is useful with CRT terminals to prevent output from disap- 
pearing before it can be read. While output is suspended, STOP 
characters are ignored and not read. 

START (Control-Q or ASCII DC1) is used to resume output which has 
been suspended by a STOP character. While output is not 
suspended, START characters are ignored and not read. The 
start/stop characters can not be changed or escaped in LDISCO. 

SWTCH (Control-Z or ASCII SUB) is used by the cs/i(l) job control facil- 
ity. 

The following characters have special functions on input when the line dis- 
cipline is set to LDISC1. These functions and their default character values 

are summarized as follows: 

LNEXT (Control- V) causes the next character input to treated literally. 
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WERASE (Control-W) erases the preceding white space-delimited word. 

It will not erase beyond the start of a line, as delimited by a NL, 
EOF, or EOL character. 

RPRNT (Control-R) causes the line to be reprinted. 

FLUSHO (Control-O) when typed during output causes the output to be 
discarded. Typing any character re-enables output. 

The character values for INTR, QUIT, ERASE, KILL, EOF, SWTCH, STOP, 
START, LNEXT, WERASE, RPRNT, FLUSHO, and EOL may be changed to 
suit individual tastes (see stty( 1)). The ERASE, KILL, and EOF characters 
may be entered literally in LDISCO by preceding them with the escape char- 
acter (\), in which case no special function is done and the escape character 
is not read. In LDISC1, the LNEXT character is used. 

The special control characters are defined by the array c_cc. The relative 
positions and initial values for each function are as follows: 


VINTR 

CINTR 

(DEL) 

VQUIT 

CQUIT 

(ControlA) 

VERASE 

CERASE 

(Control-H (backspace)) 

VKILL 

CKILL 

(Control-U) 

VEOF 

CEOF 

(Control-D (EOT)) 

VEOL 

NUL 


VEOL2 

NUL 


VSWTCH 

CNSWTCH 

NUL 


If the line discipline ( c_line ) is set to LDISC1, then additional control char- 
acters are defined: 


VLNEXT 

VWERASE 

VRPRNT 

VFLUSHO 

VSTOP 

VST ART 


CLNEXT 

C WERASE 

CRPRNT 

CFLUSHO 

CSTOP 

CSTART 


(Control-V) 

(Control-W) 

(Control-R) 

(Control-O) 

(Control-S) 

(Control-Q) 


The cjflag field describes the basic terminal input control: 

IGNBRK 0000001 Ignore break condition. 

BRKINT 0000002 Signal interrupt on break. 

IGNPAR 0000004 Ignore characters with parity errors. 
PARMRK 0000010 Mark parity errors. 

INPCK 0000020 Enable input parity check. 

ISTRIP 0000040 Strip character. 
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INLCR 0000100 Map NL to CR on input. 

IGNCR 0000200 Ignore CR. 

ICRNL 0000400 Map CR to NL on input. 

IUCLC 0001000 Map upper-case to lower-case on input. 

IX ON 0002000 Enable start/stop output control. 

IXANY 0004000 Enable any character to restart output. 

IXOFF 0010000 Enable start/stop input control. 

If IGNBRK is set, the break condition (a character framing error with data 
all zeros) is ignored, that is, not put on the input queue and therefore not 
read by any process. Otherwise if BRKINT is set, the break condition will 
generate an interrupt signal and flush both the input and output queues. If 
IGNPAR is set, characters with other framing and parity errors are ignored. 

If PARMRK is set, a character with a framing or parity error which is not 
ignored is read as the three-character sequence: 0377, 0, X, where X is the 
data of the character received in error. To avoid ambiguity in this case, if 
ISTRIP is not set, a valid character of 0377 is read as 0377, 0377. If 
PARMRK is not set, a framing or parity error which is not ignored is read as 
the character NUL (0). 

If INPCK is set, input parity checking is enabled. If INPCK is not set, input 
parity checking is disabled. This allows output parity generation without 
input parity errors. 

If ISTRIP is set, valid input characters are first stripped to 7-bits, otherwise 
all 8-bits are processed. 

If INLCR is set, a received NL character is translated into a CR character. If 
IGNCR is set, a received CR character is ignored (not read). Otherwise if 
ICRNL is set, a received CR character is translated into a NL character. 

If IUCLC is set, a received upper-case alphabetic character is translated into 
the corresponding lower-case character. 

If EXON is set, start/stop output control is enabled. A received STOP charac- 
ter will suspend output and a received START character will restart output. 
All start/stop characters are ignored and not read. If IXANY is set, any 
input character, will restart output which has been suspended. 

If IXOFF is set, the system will transmit START/STOP characters when the 
input queue is nearly empty/full. 

The initial input control value is all-bits-clear. 

The c_oflag field specifies the system treatment of output: 

OPOST 0000001 Postprocess output. 

OLCUC 0000002 Map lower case to upper on output. 

ONLCR 0000004 Map NL to CR-NL on output. 
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OCRNL 

0000010 Map CR to NL on output. 

ONOCR 

0000020 No CR output at column 0. 

ONLRET 

0000040 NL performs CR function. 

OFILL 

0000100 Use fill characters for delay. 

OFDEL 

0000200 Fill is DEL, else NUL. 

NLDLY 

0000400 Select new-line delays: 

NLO 

0 

NL1 

0000400 

CRDLY 

0003000 Select carriage-return delays: 

CRO 

0 

CR1 

0001000 

CR2 

0002000 

CR3 

0003000 

TABDLY 

0014000 Select horizontal-tab delays: 

TABO 

0 

TAB1 

0004000 

TAB2 

0010000 

TAB3 

0014000 Expand tabs to spaces. 

BSDLY 

0020000 Select backspace delays: 

BSO 

0 

BS1 

0020000 

VTDLY 

0040000 Select vertical-tab delays: 

VTO 

0 

VT1 

0040000 

FFDLY 

0100000 Select form-feed delays: 

FFO 

0 

FF1 

0100000 


If OPOST is set, output characters are post-processed as indicated by the 
remaining flags, otherwise characters are transmitted without change. 

If OLCUC is set, a lower-case alphabetic character is transmitted as the 
corresponding upper-case character. This function is often used in conjunc- 
tion with IUCLC. 

If ONLCR is set, the NL character is transmitted as the CR-NL character pair. 
If OCRNL is set, the CR character is transmitted as the NL character. If 
ONOCR is set, no CR character is transmitted when at column 0 (first posi- 
tion). If ONLRET is set, the NL character is assumed to do the carriage- 
return function; the column pointer will be set to 0 and the delays specified 
for CR will be used. Otherwise the NL character is assumed to do just the 
line-feed function; the column pointer will remain unchanged. The column 
pointer is also set to 0 if the CR character is actually transmitted. 

The delay bits specify how long transmission stops to allow for mechanical 
or other movement when certain characters are sent to the terminal. In all 
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cases a value of 0 indicates no delay. If OFILL is set, fill characters will be 
transmitted for delay instead of a timed delay. This is useful for high baud 
rate terminals which need only a minimal delay. If OFDEL is set, the fill 
character is DEL, otherwise NUL. 

If a form-feed or vertical-tab delay is specified, it lasts for about 2 seconds. 

New-line delay lasts about 0.10 seconds. If ONLRET is set, the carriage- 
return delays are used instead of the new-line delays. If OFILL is set, two 
fill characters will be transmitted. 

Carriage-return delay type 1 is dependent on the current column position, 
type 2 is about 0.10 seconds, and type 3 is about 0.15 seconds. If OFILL is 
set, delay type 1 transmits two fill characters, and type 2, four fill charac- 
ters. 

Horizontal-tab delay type 1 is dependent on the current column position. 
Type 2 is about 0.10 seconds. Type 3 specifies that tabs are to be expanded 
into spaces. If OFILL is set, two fill characters will be transmitted for any 
delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, one fill character 
will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 

The c_cflag field describes the hardware control of the terminal: 


CBAUD 

0000017 

Baud rate: 

B0 

0 

Hang up 

B50 

0000001 

50 baud 

B75 

0000002 

75 baud 

B110 

0000003 

110 baud 

B134 

0000004 

134 baud 

B150 

0000005 

150 baud 

B200 

0000006 

200 baud 

B300 

0000007 

300 baud 

B600 

0000010 

600 baud 

B1200 

0000011 

1200 baud 

B1800 

0000012 

1800 baud 

B2400 

0000013 

2400 baud 

B4800 

0000014 

4800 baud 

B9600 

0000015 

9600 baud 

B 19200 

0000016 

19200 baud 

EXTA 

0000016 

External A 

B 3 8400 

0000017 

38400 baud 

EXTB 

0000017 

External B 
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CSIZE 

0000060 

Character size: 

CS5 

0 

5 bits 

CS6 

0000020 

6 bits 

CS7 

0000040 

7 bits 

CS8 

0000060 

8 bits 

CSTOPB 

0000100 

Send two stop bits, else one. 

CREAD 

0000200 

Enable receiver. 

PARENB 

0000400 

Parity enable. 

PARODD 

0001000 

Odd parity, else even. 

HUPCL 

0002000 

Hang up on last close. 

CLOCAL 

0004000 

Local line, else dial-up. 

RCV1EN 

0010000 


XMT1EN 

0020000 


LOBLK 

0040000 

Block layer output. 


The CBAUD bits specify the baud rate. The zero baud rate, BO, is used to 
hang up the connection. If BO is specified, the data-terminal-ready signal 
will not be asserted. Normally, this will disconnect the line. For any partic- 
ular hardware, impossible speed changes are ignored. 

The CSIZE bits specify the character size in bits for both transmission and 
reception. This size does not include the parity bit, if any. If CSTOPB is 
set, two stop bits are used, otherwise one stop bit. For example, at 110 
baud, two stops bits are required. 

If PARENB is set, parity generation and detection is enabled and a parity bit 
is added to each character. If parity is enabled, the PARODD flag specifies 
odd parity if set, otherwise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no characters will be 
received. 

If HUPCL is set, the line will be disconnected when the last process with the 
line open closes it or terminates. That is, the data-terminal-ready signal will 
not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct connection with 
no modem control. Otherwise modem control is assumed. 

If LOBLK is set, the output of a job control layer will be blocked when it is 
not the current layer. Otherwise the output generated by that layer will be 
multiplexed onto the current layer. 

The initial hardware control value after open usually is B9600, CS8, 
CREAD, HUPCL. These initial values depend on the driver; see duart(l ) 
and cdsio{l). 

The cjflag field of the argument structure is used by the line discipline to 
control terminal functions. The basic line discipline ( LDISCO) provides the 
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following: 

ISIG 0000001 Enable signals. 

ICANON 0000002 Canonical input (erase and kill processing). 
XCASE 0000004 Canonical upper/lower presentation. 

ECHO 0000010 Enable echo. 

ECHOE 0000020 Echo erase character as BS-SP-BS. 

ECHOK 0000040 Echo NL after kill character. 

ECHONL 0000100 Echo NL. 

NOFLSH 0000200 Disable flush after interrupt or quit. 

If ISIG is set, each input character is checked against the special control 
characters INTR, SWTCH, and QUIT. If an input character matches one of 
these control characters, the function associated with that character is per- 
formed. If ISIG is not set, no checking is done. Thus these special input 
functions are possible only if ISIG is set. These functions may be disabled 
individually by changing the value of the control character to an unlikely or 
impossible value (e.g., 0377). 

If ICANON is set, canonical processing is enabled. This enables the erase 
and kill edit functions, and the assembly of input characters into lines del- 
imited by NL, EOF, and EOL. If ICANON is not set, read requests are 
satisfied directly from the input queue. A read will not be satisfied until at 
least MIN characters have been received or the timeout value TIME has 
expired between characters. This allows fast bursts of input to be read 
efficiently while still allowing single character input. The MIN and TIME 
values are stored in the position for the EOF and EOL characters, respec- 
tively. The time value represents tenths of seconds. 

Setting both MIN and TIME to 1 and turning off echoing is similar to RAW- 
mode in the 4.3BSD tty driver. 

If XCASE is set, and if ICANON is set, an upper-case letter is accepted on 
input by preceding it with a \ character, and is output preceded by a \ char- 
acter. In this mode, the following escape sequences are generated on output 
and accepted on input: 

for : use: 

V 

I \! 

V 

{ \( 

} \) 

\ w 

For example, A is input as \a, \n as \\n, and \N as \\\n. 
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If ECHO is set, characters are echoed as received. 

When ICANON is set, the following echo functions are possible. If ECHO 
and ECHOE are set, the erase character is echoed as ASCII BS SP BS, which 
will clear the last character from a CRT screen. If ECHOE is set and ECHO 
is not set, the erase character is echoed as ASCII SP BS. If ECHOK is set, the 
NL character will be echoed after the kill character to emphasize that the 
line will be deleted. Note that an escape character preceding the erase or 
kill character removes any special function. If ECHONL is set, the NL char- 
acter will be echoed even if ECHO is not set. This is useful for terminals set 
to local echo (so-called half duplex). Unless escaped, the EOF character is 
not echoed. Because EOT is the default EOF character, this prevents termi- 
nals that respond to EOT from hanging up. 

If NOFLSH is set, the normal flush of the input and output queues associated 
with the quit, switch, and interrupt characters will not be done. 

The initial line-discipline control value is all bits clear. 

The primary ioctl { 2) system calls have the form: 

ioctl (hides, command, arg) 
struct termio *arg; 

The commands using this form are: 


TCGETA 

Get the parameters associated with the terminal and 
store in the termio structure referenced by arg. 

TCSETA 

Set the parameters associated with the terminal from 
the structure referenced by arg. The change is 
immediate. 

TCSETAW 

Wait for the output to drain before setting the new 
parameters. This form should be used when chang- 
ing parameters that will affect output. 

TCSETAF 

Wait for the output to drain, then hush the input 
queue and set the new parameters. 

Additional ioctl (2) calls have the form: 

ioctl (hides, 
int arg; 

command, arg) 

The commands using 

this form are: 

TCSBRK 

Wait for the output to drain. If arg is 0, then send a 
break (zero bits for 0.25 seconds). 

TCXONC 

Start/stop control. If arg is 0, suspend output; if 1, 
restart suspended output. 
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TCFLSH If arg is 0, flush the input queue; if 1, flush the output 
queue; if 2, flush both the input and output queues. 

FILES 

/dev/tty* 

SEE ALSO 

stty(l) in the User’s Reference Manual. 

fork(2), ioctl(2), setpgrp(2), signal(2) in the Programmer' s Reference 
Manual. 

ORIGIN 

AT&T V.3 

Extensions by Silicon Graphics, Inc. 
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NAME 

tps - SCSI 1/4-inch Cartridge tape interface 

SYNOPSIS 

/dev/mt/tps* 

/dev/rmt/tps* 

DESCRIPTION 

The IRIS-4D series workstations support the Small Computer System Inter- 
face (SCSI) for 1/4-inch Cartridge tapes, and is compatible with the IRIS 
2000 and 3000 series workstations (see NOTE below). 

The special files are named according to the convention discussed in 
intro(7): 

/dev/{r}mt/tps<controller-#>d<slave-#>{nr}{ns}{.density} 

There are no choices for density, and that portion of the device name is 
always blank. 

These special devices are accessable by only one user at a time. 

Typically, if this device is used as the system tape drive, the device specific 
names described here are linked to user friendly names in the /dev direc- 
tory. The following table lists the device specific name and its correspond- 
ing user friendly name: 


Device Specific 

User Friendly 

Comments 

Name 

Name 


/dev/mt/tps0d7 

/dev/tape 

Rewind device 

(Standard Interface). 

Bytes are swapped in 
order to be compati- 
ble with the IRIS 
series 2000 and 3000 
workstations. 

/dev/mt/tps0d7nr 

/dev/nrtape 

Non-rewinding dev- 
ice (the tape does not 
automatically re- 

wind when closed). 

Bytes are swapped in 
order to be compati- 
ble with the IRIS 
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/dev/mt/tps0d7ns /dev/tapens 

/dev/mt/nrtps0d7ns /dev/nrtapens 


series 2000 and 3000 
workstations. 

Rewind device. 

Bytes are not 

swapped. 

Non-rewinding dev- 
ice (the tape does not 
automatically re- 
wind when closed). 

Bytes are not 

swapped. 


NOTE 

High density tapes such as the 3M 600 XTD written on an Eclipse, or other 
system equipped with high density tape drives can NOT be read on older 
systems. Even if a "low density" tape is used, it is still written at a higher 
density than older tape drives can read. Tapes written on the older systems 
can still be read on the new tape drives, however. 

FILES 

/dev/mt/tps* 

/dev/rmt/tps* 

SEE ALSO 

intro(7), mtio(7m) 


Version 1.0 


- 2 - 


September 1988 



TS(7M) 


Silicon Graphics 


TS(7M) 


NAME 

ts - ISI VME-QIC2/X cartridge tape controller 

SYNOPSIS 

/dev/m t/ts* 

/dev/rmt/ts* 

DESCRIPTION 

The IRIS -4 D series system supports the ISI quarter inch cartridge tape, 
using the QIC-02 format, and is compatible with the IRIS series 2000 and 
IRIS series 3000 workstations. The special files are named according to the 
convention discussed in intro(7): 

/dev/{r}mt/ts<controller-#>d<slave-#>{nr}{ns}{.density} 

Currently, only one controller and one slave per controller are supported, so 
the <controIIer-#> and <slave-#> are always 0. There are no choices for 
density, and that portion of the device name is always blank. 

These special devices are accessable by only one user at a time. 

Typically, if this device is used as the system tape drive, the device specific 
names described here are finked to user friendly names in the /dev direc- 
tory. The following table fists the device specific name and its correspond- 
ing user friendly name: 


Device Specific 

User Friendly 

Comments 

Name 

Name 


/dev/mt/ts0d0 

/dev/tape 

Rewind device 

(Standard Interface). 
Bytes are swapped in 
order to be compati- 
ble with the IRIS 
2000 and 3000 
workstation family. 

/dev/mt/ts0d0nr 

/dev/nrtape 

Non-rewinding dev- 
ice. Bytes are 

swapped in order to 
be compatible with 
the IRIS 2000 and 
3000 workstation 
family. 

/dev/m t/tsOdOns 

/dev/tapens 

Rewind device. 
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Bytes are 
swapped. 

/dev/mt/tsOdOnms /dev/nrtapens Non-rewinding dev- 
ice. Bytes are not 
swapped. 


FILES 

/dev/mt/ts* 

/dev/rmt/ts* 

SEE ALSO 

cpio(l), mt(l), tar(l), intro(7), mtio(7) 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

tty - controlling terminal interface 
DESCRIPTION 

The file Idevltty is, in each process, a synonym for the control terminal asso- 
ciated with the process group of that process, if any. It is useful for pro- 
grams or shell sequences that wish to be sure of writing messages on the 
terminal no matter how output has been redirected. It can also be used for 
programs that demand the name of a file for output, when typed output is 
desired and it is tiresome to find out what terminal is currently in use. 

FILES 

/dev/tty 

/dev/tty* 

SEE ALSO 

console(7) 

ORIGIN 

AT&T V.3 
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NAME 

udp - Internet User Datagram Protocol 
SYNOPSIS 

#include <sys/socket.h> 

#include <netinet/in.h> 

s = socket(AF_INET, SOCK DGRAM, 0); 

DESCRIPTION 

UDP is a simple, unreliable datagram protocol which is used to support the 
SOCKJDGRAM abstraction for the Internet protocol family. UDP sockets 
are connectionless, and are normally used with the sendto and recvfrom 
calls, though the connect^ 2) call may also be used to fix the destination for 
future packets (in which case the recv{ 2) or read(2 ) and send( 2) or write(2) 
system calls may be used). 

UDP address formats are identical to those used by TCP. In particular UDP 
provides a port identifier in addition to the normal Internet address format. 
Note that the UDP port space is separate from the TCP port space (i.e. a 
UDP port may not be “connected” to a TCP port). In addition broadcast 
packets may be sent (assuming the underlying network supports this) by 
using a reserved “broadcast address”; this address is network interface 
dependent. 

Options at the IP transport level may be used with UDP; see ip(JP). 
DIAGNOSTICS 

A socket operation may fail with one of the following errors returned: 

[EISCONN] when trying to establish a connection on a socket which 
already has one, or when trying to send a datagram with 
the destination address specified and the socket is already 
connected; 

[ENOTCONN] when trying to send a datagram, but no destination 
address is specified, and the socket hasn’t been con- 
nected; 

[ENOBUFS] when the system runs out of memory for an internal data 
structure; 

[EADDRINUSE] when an attempt is made to create a socket with a port 
which has already been allocated; 

[E ADDRNOT A V AIL] 

when an attempt is made to create a socket with a net- 
work address for which no network interface exists. 

NOTE 

To compile and link a program that uses sockets, follow the procedures for 
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section (3B) routines as described in intro{ 3). 

SEE ALSO 

getsockopt(2), recv(2), send(2), socket(2), intro(3), inet(7P), ip(7P), tcp(7P) 

ORIGIN 

4.3BSD 


Version 1.0 
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NAME 

vh - disk volume header. 

DESCRIPTION 

The volume header is a small partition at the start of every SGI disk. Typi- 
cally it occupies about 1 megabyte, exact size depends on disk geometry 
since it is an integral number of cylinders. 

It contains identifying information for the disk, and may also contain some 
files used in standalone operations when the operating system is not run- 
ning. 

The volume header of the system root disk may be accessed as Idevlvh (or 
Idevlrvh , for the block and character devices respectively). 

The volume header partitions of other disks may be accessed via the 
appropriate files in the Idevldsk or /dev/rdsk directories; the volume header 
special files are identified by the suffix ‘vh’. 

The first sector of the volume header (and hence the first sector on the entire 
disk) contains the disk label. The structure of this is defined in the file 
<sys/dvh.h>. The file is quite extensively commented, and it is worth refer- 
ring to it as a supplement to the information in this man page. For security, 
the label sector is also replicated at the first sector of each track of the first 
cylinder. 

The disk label contains the following sections: 

Magic Number 

This is a unique number which serves to verify that the sector does 
contain a label. 

Root Partition Identifier. 

If the disk is a root disk, this field identifies the partition to be used 
as the root partition. The information is used by the boot PROMs 
when the system is booting up. 

Swap Partition Identifier. 

This is also information used during system boot. 

Boot Filename 

This is also information used during system boot, it identifies the 
executable file to be loaded by default (normally the operating sys- 
tem). 

Device Parameters. 

This section contains information about the particular disk drive 
(eg number of cylinders). It is retrieved by the driver during sys- 
tem startup, and used to configure the disk controller with the 
parameters it needs to work correctly with the drive. 
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Volume Directory 

As well as the label, the volume header partition can be used to 
store files in the remaining space. Note that these are NOT regular 
system files; they are accessed only via the PROM or standalone 
shell and will not appear in any regular directory. Typically they 
will be special executable files such as the standalone version of 
the disk utility /x(lM). They are used for performing special- 
purpose tasks on the machine when the operating system is not 
running. 

The Volume Directory is a table in the disk label which enables 
such files to be located by the PROMs. Files in the volume header 
may be added or removed by dvhtool{ lm). 

Partitions 

Disk space is required for a number of different purposes in a sys- 
tem. It is not usually practical or desirable to dedicate an entire 
physical disk to each use, so the disk surface is divided into a 
number of partitions. Typically a partition will contain a filesystem 
(such as / usr ), or will be used for non-filesystem storage, such as 
swap. The volume header itself is also a partition. Partitions may 
overlap: for example, the vol partition is defined to be the whole 
disk, (useful for disk cloning). 

In order to direct I/O requests to the correct part of the disk, the 
driver must know the layout of the partitions. This is specified in 
the partition table contained in the disk label. 

The disk label is set up by fx when the disk is first initialized for the system. 
A convenient summary of its contents may be printed by prtvtoc{ lm). 
dvhtool gives more detailed information, and is also used for manipulating 
files in the header partition. 


FILES 

/dev/vh 

/dev/rvh 

/dev/dsk/ips#d#vh 

/dev/rdsk/ips#d#vh 

/dev/dsk/dks#d#vh 

/dev/rdsk/dks#d#vh 

SEE ALSO 

dvhtool(lM), prtvtoc(lM), fx(lm). 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

xmt - Xylogics 1/2 inch magnetic tape controller 

SYNOPSIS 

/dev/mt/xmt* 

/dev/rmt/xmt* 

DESCRIPTION 

This is the driver for the Xylogics Model 772 1/2 inch magnetic tape con- 
troller. The driver supports any Cipher 88X or 99X tape drive. Reads and 
writes of up to 30k bytes are allowed. The standard tape iocd calls are pro- 
vided (see mtio(J)). The special files are named according to the conven- 
tion discussed in intro(7): 

/dev/{r}mt/xmt<controller-#>d<slave-#>{nr}{.density} 

Valid densities are one of 800, 1600, 3200, or 6250. Cooked tape files exist 
in the directory /dev/mt. Raw tape files exist in the directory /dev/rmt. For 
example, /dev/rmt/xmt0d0nr.l600 is the name of the raw no-rewind 1600 
bpi tape device. 

Only one of the device files associated with a single drive may be opened at 
a time. 

FILES 

/dev/mt/xmt* 

/dev/rmt/xmt* 

SEE ALSO 

cpio(l), mt(l), mtio(7m), tar(l) 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 

xyl, xyl754 - Xy logics disk controllers and driver. 

SYNOPSIS 

/dev/dsk/xyl* 

/dev/rdsk/xyl* 

DESCRIPTION 

The IRIS-4D system supports the Xylogics 754 SMD disk controller. A 
system may contain a maximum of 2 Xylogics controllers, and each con- 
troller may have up to 4 SMD disk drives connected to it. 

The special files are named according to the convention discussed in 
intro (7M): 

/dev/{r}dsk/xyI<controller-#>d<drive-#>{s<partition-#>|vh|vol} 

Controller numbers run from 0 to 1 for the two possible controllers in a sys- 
tem. Drive numbers run from 0 to 3. 

The kernel driver for the xylogics controller is referred to as xyl754 . 

IOCTL FUNCTIONS 

As well as normal read and write operations, the driver supports a number 
of special io control (ioctl) operations when opened via the character spe- 
cial file in /dev/rdsk. These may be invoked from a user program by the 
ioctl system call, see ioctl(2). Command values for these are defined in the 
system include file <sys/dkio.h>. 

These ioctl operations are intended for the use of special-purpose disk utili- 
ties. Many of them can have drastic or even fatal effects on disk operation 
if misused; they should be invoked only by the knowledgeable and with 
extreme caution! 

A list of the ioctl commands supported by the xyl754 driver is given below. 
DIOCGETVH 

reads the disk volume header from the driver into a buffer in the 
calling program. The arg in the ioctl call is expected to point to a 
buffer of size at least 512 bytes. The structure of the volume 
header is defined in the include file <sys/dvh.h>. 

DIOCHANDSHAKE 

reads identifying data from the controller firmware into a buffer in 
the calling program. The arg of the iocd call should point to a 
buffer at least 16 bytes long. The identifying data is a ’struct 
CONTROLLER_TABLE’, defined in <sys/xl.h>. 
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DIOCRAWREAD 

This is something of a misnomer; what it actually does is to invoke 
a controller command for reading the flawmap information placed 
on the disk by the original manufacturer in accordance with the 
SMD specification. The amount of data returned to the calling pro- 
gram is always 512 bytes and the program must provide a buffer of 
this size to receive it. The operation is controlled by a structure 
which must be pointed to by the arg of the ioctl call; this is a 
’struct rawread_info’ which is defined in <sys/dvh.h>. Flawmaps 
are always at the start of tracks, however for historical reasons the 
identifying argument is an absolute blocknumber rather than a 
cylinder/head specification. Thus it is necessary to know the 
geometry of the disk in order to construct the arguments. For the 
interpretation of the returned data, see the SMD interface 
specification. 

DIOCSENSE 

causes the current controller parameters to be printed on the sys- 
tem console. These are the fields of a ’struct 
CONTROLLER_TABLE’, defined in <sys/xl.h>. 

The remaining commands should be used with extreme caution, 
since misuse can render a disk at least temporarily unreadable, or 
at worst destroy data on the disk. 

DIOCSETVH 

transfers a new volume header into the driver, and causes the disk 
drive to be reconfigured in accordance with the parameters in the 
new volume header. The arg in the ioctl call is expected to point 
to a buffer containing a valid volume header with parameters 
appropriate for the drive. 

DIOCFMTMAP 

formats a track on the disk, or maps a track to a replacement track, 
according to information passed in a buffer pointed to by the arg of 
the ioctl call. The arg should point to a ’struct fmt_map_info’, 
which is defined in the include file <sys/dvh.h>. Note that 
although this contains definitions for a number of other possible 
actions, only formatting a track and mapping a track are currently 
supported. The track(s) to be acted on must be specified in the 
form of cylinder/head numbers, and these are absolute numbers 
starting from the beginning of the disk (that is to say, NOT from 
start of the currently open partition). 
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FILES 

/dev/dsk/xyl* 

/dev/rdsk/xyl* 

/usr/include/sys/dkio.h/usr/include/sys/dvh.h /usr/include/sys/xl.h 

BUGS 

For historical reasons, the names of the ioctls are not always logical, and 
their arguments are an irregular mess. 

ORIGIN 

Silicon Graphics, Inc. 
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NAME 


zero - source of zeroes 


DES CRIPTION 

A zero special file is a source of zeroed unnamed memory. 

Reads from a zero special file always return a buffer full of zeroes. The file 
is of infinite length. 

Writes to a zero special file are always successful, but the data wntten is 
ignored. 

Mapping a zero special file creates a zero-initialized unnamed memory 
object of a length equal to the length of the mapping and rounded up to the 
nearest page size as returned by getpagesize( 2). Multiple processes can 
share such a zero special file object provided a common ancestor mapped 
the object MAP_SHARED. 


FILES 

/dev/zero 

SEE ALSO 

fork(2), mmap(2) 

ORIGIN 

4.3BSD 
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